name: "skill-name" description: "Short description of what this skill does."

Trigger and Scope

When to use

• Describe concrete task signals that should trigger this skill.

When not to use

• Describe clear boundaries and non-goals.

Inputs

Arguments

• Describe $ARGUMENTS parsing rules.
• Document defaults.
• Document edge cases and invalid argument handling.

Execution Workflow

1. List required prechecks.
2. List ordered execution steps.
3. List required validations before returning.

Validation

• Required commands/tests to establish confidence.
• Expected outputs or pass criteria.

Output Contract

• Required response structure.
• Required artifacts and where they are written.
• How to report partial completion and blockers.

Safety

• Forbidden actions.
• Recovery/fallback behavior when preconditions fail.