Skip to main content
Gandalf runs on macOS (Apple silicon and Intel).

​
Skill directories

With --scope project the same directories are read under the repository root (.claude/skills/, .agents/skills/, and so on). These follow each agent’s own documentation. Codex and Cursor both read the shared ~/.agents/skills/, so one copy there serves both, and Cursor also reads the Claude Code directory. When an agent reads several directories and more than one holds a skill of the same name, the first directory in its list wins, matching the agent’s own precedence.

​
What counts as a skill

A skill is a directory directly inside one of the directories above that contains a SKILL.md file. The directory name is the skill name.
  • Directories without SKILL.md are ignored.
  • Directories whose name starts with . are ignored, including agent-bundled skills such as ~/.codex/skills/.system.
  • Skills nested deeper than one level are not listed.
  • Skills that an agent loads from elsewhere (plugins, marketplaces) are not listed.

​
How copies are compared

Two copies are the same when their files have identical paths and content. File permissions, timestamps, .DS_Store, and .git are not compared.

​
Not managed

MCP servers, hooks, permissions, agent settings, and plugins are outside Gandalf’s scope. The one exception is Gandalf’s own handoff integration, which gandalf init registers in Claude Code and Codex.