| name | skill-writing |
| description | Use when creating or normalising reusable proposal skills, trigger routes, contracts, references, or authoring automation; use skill-safety-audit instead for a read-only security review. |
| metadata | {"portable":true,"compatible_with":["claude-code","codex"]} |
Skill Writing
Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178.
Create concise, portable proposal procedures that another agent can route, execute, verify, and hand off without depending on one runner.
Use When
- Create or upgrade an active proposal skill, its trigger description, or its directly linked resources.
- Normalise a catalogue cohort against the July 2026 authoring and composition contract.
- Add deterministic authoring or validation helpers that reduce repeatable structural errors.
Do Not Use When
- Use
skill-safety-audit for a read-only inspection of unsafe instructions or bundled resources.
- Do not create a new skill for a one-off request, generic knowledge, or a metric improvement.
Inputs
| Artefact | Source/provider | Required? | Missing-input behaviour |
|---|
| Repeatable problem and representative prompts | User or catalogue evidence | Yes | Stop; do not invent a trigger without a demonstrated workflow. |
| Neighbouring skill descriptions | Live skills/**/SKILL.md catalogue | Yes |