Skill Writing

Goal

Produce a usable Skill package: SKILL.md (always) + optional reference files and scripts (when helpful). Optimize for: discoverability, correctness, concision, testability.

Output contract

When triggered, deliver:

1. SKILL.md with valid YAML frontmatter (name, description)
2. If needed: suggested folder layout + filenames + brief contents for each extra file (do NOT bloat SKILL.md)
3. 3+ evaluation prompts to test activation + behavior

Workflow (do in order)

1) Extract requirements

Capture (infer if missing):

• Primary job: what the Skill reliably accomplishes
• Triggers: phrases/users requests that should activate it
• Inputs: files/types/tools needed (pdf/docx/xlsx/pptx, repos, APIs, etc.)
• Constraints: tone, formatting, compliance, latency, determinism
• Failure modes: common mistakes to guardrail