write-a-skill

Installation
SKILL.md

Writing Skills

A skill exists to wrangle determinism out of a stochastic system. Predictability — the agent taking the same process every run, not producing the same output — is the root virtue; every rule below serves it. When a drafted skill misbehaves, diagnose it against the failure modes in principles.md.

Principles adapted from writing-great-skills in mattpocock/skills.

Process

  1. Gather requirements — done when each of these has an answer:

    • What task/domain does the skill cover, and which distinct use cases (branches) must it handle?
    • Model-invoked or user-invoked? (see Invocation)
    • Does it need executable scripts or just instructions?
    • Any reference materials to include?
  2. Draft the skill — done when the draft passes every item on the Review Checklist:

    • SKILL.md with concise instructions
    • Disclosed reference files for material only some branches need
    • Utility scripts if deterministic operations are needed
Installs
7
Repository
amit-t/skills
GitHub Stars
4
First Seen
Apr 2, 2026