liveBook · Manning

Skill directory

As explained in Build a Multi-Agent System (from Scratch)

A skill repository is a storage location for skill bundles, defined according to an agent application's and skill's scope.

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

How Build a Multi-Agent System (from Scratch) covers it

How deep it goes
Explains bundle contents and scope-dependent paths, but does not detail repository scanning or discovery mechanics.
Examples
Shows .claude/skills, .cursor/skills, and .agents/skills as project- or user-scoped locations.
What you can do after
Configure skill bundle locations for project, user, or cross-client access.
How it connects
Links skill repositories to skill bundles, SKILL.md, project and user scope, and skill discovery.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Build a Multi-Agent System (from Scratch). The section links point to the parts of the book it draws on.