skill-writing

Installation
SKILL.md

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
Related skills
Installs
19
GitHub Stars
13
First Seen
Feb 3, 2026