Agent skill · Documentation

writing-great-skills

Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill writing-great-skills --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 10 KB
Bundled scripts: none
Declared author: Matt Pocock
Path: skills/writing-great-skills/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

## When to Use Use when this workflow matches the user request: Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable. _Source: [mattpocock/skills](https://github.com/mattpocock/skills) (MIT)._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 lever below serves it. **Bold terms** are defined in [`GLOSSARY.md`](GLOSSARY.md); look them up there for the full meaning. ## Invocation Two choices, trading different costs: - A **model-invoked** skill keeps a **description**, so the agent can fire it autonomously _and_ other skills can reach it (you can still type its name too). It contributes to **context load** — the description sits in the window every turn. Mechanics: omit `disable-model-invocation`, and write a model-facing description with rich trigger phrasing ("Use when the user wants…, mentions…"). - A **user-invoked** skill strips the description from the agent's reach: only you, typing its name, can invoke it — and no other skill can. Zero context load, but it spends **cognitive load**:

What's inside
Steps it walks through
  1. When to Use
  2. Invocation
  3. Writing the description
  4. Information hierarchy
  5. When to split
  6. Pruning
  7. Leading words
  8. Failure modes
  9. Limitations
Ships with 1 file
  • GLOSSARY.md
More from agentic-awesome-skills
All skills →
About this skill
What does the writing-great-skills skill do?

Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill writing-great-skills --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going