Custom skills from your repos
Add project-scoped Agent Skills from skill directories in your repositories.
You can add custom skills by including them in your repo. Superconductor picks up agent-specific skill directories and makes them available to agents automatically.
Open standard
Custom skills are built on the Agent Skills open standard for giving agents new capabilities and expertise. The shared [repo]/.agents/skills/ path works across all Superconductor agents.
Supported skill directories
| Agent | Skills directories |
|---|---|
| Claude Code | [repo]/.claude/skills/ or [repo]/.agents/skills/ |
| Codex | [repo]/.codex/skills/ or [repo]/.agents/skills/ |
| Amp | [repo]/.agents/skills/ |
| OpenCode | [repo]/.opencode/skills/ or [repo]/.agents/skills/ |
| Pi | [repo]/.agents/skills/ |
If multiple repos define a skill with the same name, the first repo alphabetically wins.
When to use custom skills
Use custom skills when you want agents to reuse project-specific instructions, workflows, scripts, or reference material. For example:
- Generate visual database structure diagrams
- Follow your team's release checklist
- Query an internal service with a repo-provided script
- Apply domain-specific review guidelines