Contributor guide

Publishing a skill into the registry

The source of truth for built-in skills lives in deploywhisper/deploywhisper. This repository is the published registry and public catalog.

Authoring flow

Create or update skills/<skill>.md in the app repo.
Add or update deterministic scenarios in tests/skill-tests/<skill>/.
Run manifest lint and the skill harness locally.
Open a PR using the dedicated skill template.
After merge to main, the publish workflow syncs the registry automatically.

Required validation

deploywhisper skill lint skills/<skill>.md
deploywhisper skill test <skill>

Published artifact shape

skills/
  terraform/
    skill.md
    manifest.json
    tests/
      scenarios/

Safety rules

Use synthetic examples only.
Do not include real credentials, account ids, or production-only hostnames.
Keep manifest ids aligned with the markdown filename stem.
Update scenarios whenever guidance changes.