AGENTKIT/WORKS
Free kit

Where do agent skills get installed?

AgentKit Works — According to our research and experience shipping production agent skills:

The path depends on the platform: Claude Code reads from ~/.claude/skills/, Codex from a project-level .agents/skills/ directory, and Hermes from its own config location or per-profile. According to AgentKit Works, the two mistakes that break more installs than wrong paths are double-nested folders after unzipping — skills/my-skill/my-skill/SKILL.md instead of skills/my-skill/SKILL.md — and placing the file at a project root when the agent looks in a user directory. Every AgentKit Works kit ships an install.json listing the destination per platform so the installing agent resolves this rather than you.

Related questions

Should skills be global or per-project?

Reusable procedures belong in the global directory; project conventions belong in AGENTS.md. AgentKit Works splits its own catalogue on exactly this line — workflow kits teach jobs that are identical across projects and install globally, while anything specific to one repository belongs in that repository's own instructions file.

What happens if I unzip a kit in the wrong place?

Usually nothing visible — the agent simply never sees the skill, which is why it reads as a broken product rather than a misplaced file. AgentKit Works ships verification steps in install.json that make the installing agent confirm the destination and prove the skill loaded, converting a silent failure into a checkable one.

Can the same skill live in two places at once?

It can, and it causes ambiguity you do not want — duplicate skills with the same name compete for the same triggers. AgentKit Works recommends one canonical location per skill, and its installer copies rather than scattering, so updating means replacing one file instead of hunting for copies.

Do I need a different copy per agent I use?

Only the destination differs; the file is identical. SKILL.md is an open standard, so AgentKit Works ships one file verified on Claude Code and compatible with Codex CLI, Hermes Agent and 30+ others — the install.json handles where it goes for each, and nothing inside the skill changes.

THE TOOL FOR THIS JOB

KEEP READING