Supported Tools
skul understands the directory layouts for six AI coding tools.
| Tool | Skills | Commands | Agents | Root instructions |
|---|---|---|---|---|
| Claude Code | .claude/skills | .claude/commands | .claude/agents | CLAUDE.md |
| Cursor | .cursor/skills | .cursor/commands | .cursor/agents | CLAUDE.md |
| OpenCode | .opencode/skills | .opencode/commands | .opencode/agents | CLAUDE.md |
| Codex | .agents/skills | - | .codex/agents | AGENTS.md |
| GitHub Copilot | .github/skills | - | .github/agents | .github/copilot-instructions.md |
| Kiro | .kiro/skills | - | .kiro/agents | AGENTS.md |
Root instruction bundles are translated into the native root-instruction target for each selected tool.
Target one tool or many
By default, canonical bundle content is copied into every compatible tool target.
Use --agent to constrain materialization:
skul add acme/shared-bundles core --agent codex
skul add acme/shared-bundles core --agent codex --agent cursor
This is useful when a bundle should only appear in a subset of tools for a repository.
Tracked vs untracked root targets
If the destination root instruction file is untracked, skul composes it locally and hides it through .git/info/exclude.
If the destination root instruction file is already tracked, skul switches to tracked-shadow behavior so the effective file content can be refreshed from HEAD plus bundle overlays without creating a normal working-tree diff.