Skill Name
Overview
State the core purpose in one or two sentences. Explain what this skill helps an agent do, without turning the overview into a long tutorial.
When To Use
Use this skill when:
- The task matches a repeatable workflow.
- The agent needs domain-specific constraints, tool order, or verification rules.
- The expected output has a recognizable quality bar.
Do not use this skill when:
- The task is a one-off note.
- The behavior is better enforced by code, linting, or a script.
- General documentation already covers the need clearly.
Workflow
- Gather the minimum context needed for the task.
- Follow the domain-specific steps in order.
- Stop and ask for clarification if required inputs are missing.
- Verify the result with the checks below.
Verification
Before claiming completion:
- Confirm the expected artifact exists.
- Confirm the output matches the user's request.
- Run the relevant command, checklist, or manual inspection step.
- Report any limitation or skipped check.
Common Mistakes
- Writing a broad essay instead of operational guidance.
- Making the description summarize the workflow instead of trigger conditions.
- Adding too many examples instead of one strong example.
- Forgetting verification, which makes the skill hard to trust.
Example
User: "Create a release note from these commits."
Agent:
- Loads the release-note skill because the task is a repeatable writing workflow.
- Collects commit messages and user-facing changes.
- Drafts the release note in the required format.
- Checks that the note avoids internal-only implementation details.