- Keep
official-modes/index.tsas the single plugin entrypoint. - Keep each model's prompt and tool list in its own file under
official-modes/modes/. - Keep
@amp-agent-modedirectives and literalcreateAgentmodel and effort values in the entrypoint so server metadata parsing works. - Keep each official skill in
skills/<name>/with itsSKILL.mdand reference files; the directory name must equal the frontmattername. Do not put plugin code underskills/; Amp never loads it as a plugin. - The Amp CLI ships no skill content of its own; every skill Amp provides lives here. Gate a skill in its SKILL.md frontmatter
metadatamap:feature: <flag>(the user must have that feature flag or rollout) andsandbox-only: true(advertised only on Amp-managed sandbox executors). The Puck skill list is keyed by skill name incore/src/inference/agent-modes.tsin ampcode/amp, so land that change first when Puck should see a new skill. - Run format checks before committing.
- Treat GitHub
mainas the source of truth. The mirror workflow must only fast-forward Pierre.