| name | author-workflow-skill |
| description | Create a new project SKILL.md for a repeatable workflow. Use when user asks to add a skill for vulnerabilities, package upgrades, audits, supply-chain checks, or any named agent workflow. |
Author a workflow skill
When to use
User requests: "Add a SKILL.md for …", "create a skill to …", or describes a repeatable procedure worth attaching on demand.
Steps
- Glob existing
.cursor/skills/ and .agents/skills/ — match naming and frontmatter style.
- Read 1–2 existing SKILL.md files in the repo for tone and section layout.
- Draft skill with:
- YAML
name + description (third person; include trigger phrases)
- When to use — bullet triggers
- Steps — ordered, tool-friendly (Read, Grep, Shell)
- Done when — verifiable exit criteria
- Write under
.agents/skills/<name>/SKILL.md (or project convention path).
- Optionally add a routing rule (
.mdc) telling the agent when to suggest attaching the skill.
Do not
- Paste long policy essays — skills are procedures, not style guides
- Duplicate an existing skill — extend or link instead
- Commit secrets or environment-specific paths — use
{REPO_ROOT} placeholders
Validate
Ask user to invoke /skill-name on the next matching task; compare tool pattern to gold sessions (Read → research → Shell verify).
