Skill reference
Per-tool details for the fields on the skills page.
disable-model-invocation support by target
Without the field, every tool lets the model use the skill on its own. Each target page gives the native details and links the vendor docs.
| Target | Behavior |
|---|---|
| Claude Code, Cursor, Zed, Qwen Code | Written to SKILL.md |
| Copilot | Written to SKILL.md, with argument-hint |
| OpenCode | Written to SKILL.md. V2 honors it; V1 does not |
| Codex | allow_implicit_invocation: false in agents/openai.yaml |
| Windsurf | triggers: [user] in SKILL.md |
| Crush | Written to SKILL.md with user-invocable: true |
| Factory | Dropped with a note. Set x-factory.disable-model-invocation |
| Cline, Amp, Warp, Antigravity, Continue, Gemini CLI, Goose, OpenHands | Dropped with a note: no documented field keeps a skill user-only |
Shared skills folders and Factory
- Copilot, Zed, Windsurf, Crush, and Qwen Code write the field only while no other target writes the same skills folder. Every writer of a shared
SKILL.mdmust agree on its bytes. - Otherwise the field is dropped with a note. Point the tool's
skills-dirat a folder of its own to keep it. - Factory skills go in the shared
.agents/skills/folder, where the key would reach tools that ignore it and let their models use a manual-only skill. - So while another target writes that folder,
x-factory.disable-model-invocationalso needsoutputs.factory.skills-dir: .factory/skills. Otherwise sync stops withAAI-102.