A skill directory bundles a SKILL.md file with any optional resource directories, such as scripts/, references/, and assets/. Its directory name matches the skill name in the file’s frontmatter. The repository that holds the directory is chosen by scope and agent application. section 6.1.2 section 6.6
Choose a repository location according to who should be able to access the skill:
- Place a project-scoped skill in the project directory; only that project can access it. section 6.1.2
- Place a user-scoped skill in the user’s home directory; it is available across that user’s projects. section 6.1.2
- For cross-client use in the described framework, place skills in .agents/skills. section 6.1.2 section 6.6
Table 6.3 Skill directory locations by scope and compatible agent clients
|
Path
|
Scope
|
Compatible
Agent Clients
|
|
<project-dir>/.claude/skills/
|
Project
|
Claude Code
|
|
$HOME/.claude/skills/
|
User
|
Claude Code
|
|
<project-dir>/.cursor/skills/
|
Project
|
Cursor
|
|
$HOME/.cursor/skills/
|
User
|
Cursor
|
|
<project-dir>/.agents/skills/
|
Project
|
All agent
clients
|
|
$HOME/.agents/skills/
|
User
|
All agent
clients
|
Compare project- and user-scoped skill paths for Claude Code, Cursor, and all agent clients. section 6.1.2
