Skills
A skill is a folder of instructions and files that teaches an agent how to do something: check error rates, roll back a service, query the billing database. Attach skills to the steps that need them, and every agent that claims the step gets the same, pinned version.
Directoryskills/check-error-rates/
- SKILL.md the instructions, with a name and description
Directoryqueries/
- errors-by-region.promql
- thresholds.md
-
Upload the skill to the project:
Terminal window runbook skill push skills/check-error-rates --project prodrunbook skill list --project prod -
Declare and attach it in the runbook:
error-check.yaml metadata: { id: error-check }spec:skills:error_rates: ./skills/check-error-ratessteps:- id: check_errorsactor: agentcheck: trueskill: error_ratesinstructions: Follow the skill to compare error rates before and after the deploy.skill: nameattaches one;skills: [a, b]attaches up to 8. -
Publish. Each alias is pinned to the latest uploaded version of the skill named by the path’s last segment, so a run always uses the version that was current when the runbook was published. Uploading a new version changes nothing until you publish again.
How an agent uses it
Section titled “How an agent uses it”runbook step get returns the step’s pinned skill (its SKILL.md), and the
agent fetches the other files as it needs them:
runbook step skill-file "$SR" queries/errors-by-region.promqlInstalling skills into an agent
Section titled “Installing skills into an agent”runbook skill install copies a project’s skills into an agent’s own skill
directory, so they’re available outside runs too:
runbook skill install --agent claude --project prod # ~/.claude/skills/runbook skill install --agent codex --project prod --scope project # .agents/skills/runbook skill install --agent cursor --therunbook # the therunbook skill itself