your-skill-name

[What it does — one sentence]. Use when user [trigger phrases users would actually say]. Handles [key capabilities]. Do NOT use for [negative triggers if needed to prevent over-firing].

Your Skill Name

[One paragraph: what this skill does and the outcome it produces.]

Instructions

Step 1: [First Major Step]

[Clear, specific instruction. Not "validate the data" but "Run python scripts/validate.py --input {filename} to check data format."]

  • [Substep with exact command or action]
  • [Substep with expected output]

Step 2: [Second Major Step]

[What to do, what tools to call, what parameters to pass.]

Expected output: [describe what success looks like]

Step 3: [Continue as needed]

[Keep steps sequential and unambiguous.]

Examples

Example 1: [Common Scenario]

User says: "[realistic trigger phrase]"

Actions:

  1. [What the skill does first]
  2. [What it does next]

Result: [What the user gets]

Example 2: [Edge Case]

User says: "[another realistic phrase]"

Actions:

  1. [Steps for this case]

Result: [Expected outcome]

Common Issues

[Error or problem name]

Cause: [Why it happens] Fix: [Exact steps to resolve]

[Another common issue]

Cause: [Why] Fix: [How]

Rules

  • [Non-negotiable constraint 1]
  • [Non-negotiable constraint 2]
  • [Safety rails — what the skill must never do]