What a skill is
A skill is a documented procedure an agent loads when it becomes relevant — a Markdown file with YAML frontmatter, same shape as an agent. A skill has no model and no budget of its own: an agent callsactivate_skill, and the skill’s instructions enter that agent’s context and run on its budget.
The reason skills exist is context economy. A comprehensive scanner might know how to analyze twenty
vulnerability classes, but loading all twenty procedures up front would crowd out the code it’s supposed to
be reading. Instead it loads the SQL-injection procedure when it’s looking at a query, and the SSRF
procedure when it’s looking at an outbound request.
Skill or agent?
When in doubt, start with a skill. It’s cheaper — nothing to budget, nothing to orchestrate — and you can
promote it to an agent later if it grows its own output.
Frontmatter reference
description is load-bearing: it’s what an agent reads when deciding whether this skill
applies.
Built-in skills
The scanner agents also draw on an internal library of class-specific analysis skills, which is what
distinguishes the
standard and comprehensive profiles from basic.
Where to author a skill
Skills on disk are loaded by your own CLI sessions; cloud runs don’t see them.Local files
In the CLI, a skill is a file on disk:AMPLIFY_SKILLS_DIR. Skills load at startup, so restart the CLI after adding
one.
A skill directory can hold supporting files — reference documents, example rules, helper scripts — next to
SKILL.md, and the instructions can point the agent at them.
Local files never leave your machine.
Using skills in the CLI
/skills lists the catalog: every skill this session can activate, built-in and local. Activation isn’t a
command — the agent calls activate_skill itself when a skill’s description matches the task at hand.
To test a skill you’re writing, edit the file, restart, and give the agent a task the description should
trigger. If you want a specific procedure followed, ask for it by name.
Next steps
Detections
Turn a procedure’s results into a permanent rule.
The CLI
Where skills are authored.
