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

1. Gather the minimum context needed for the task.
2. Follow the domain-specific steps in order.
3. Stop and ask for clarification if required inputs are missing.
4. 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:

1. Loads the release-note skill because the task is a repeatable writing workflow.
2. Collects commit messages and user-facing changes.
3. Drafts the release note in the required format.
4. Checks that the note avoids internal-only implementation details.