Writing Great Skills

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

5 stars 2 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add GAGAA-HUE/ASHUO-claude-skills --skill writing-great-skills
Manual install
git clone --depth 1 https://github.com/GAGAA-HUE/ASHUO-claude-skills.git /tmp/ASHUO-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ASHUO-claude-skills/writing-great-skills ~/.claude/skills/writing-great-skills

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

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**: _you_ are the index that must remember it exists. Mechanics: set `disable-model-invocation: true`; the `description` becomes human-facing — a one-line summary, trigger lists stripped.

Pick model-invocation only when the agent must reach the skill on its own, or another skill must. If it only ever fires by hand, make it user-invoked and pay no context load.
Read the full skill on GitHub

Details

Skill name
writing-great-skills
Path
writing-great-skills/SKILL.md
Repo updated
3 November 2026
Copies
Found in 2 GitHub repos

FAQ

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 the Writing Great Skills skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add GAGAA-HUE/ASHUO-claude-skills --skill writing-great-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Writing Great Skills popular?

It lives in GAGAA-HUE/ASHUO-claude-skills, which has 5 GitHub stars and 2 forks, and is included in 2 curated skill lists.

Related skills

Domain Modeling

5

GAGAA-HUE/ASHUO-claude-skills

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

AI, LLMs & AgentsIn 2 lists

Git Guardrails Claude Code

5

GAGAA-HUE/ASHUO-claude-skills

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

Git & Code ReviewIn 2 lists

Setup Pre Commit

5

GAGAA-HUE/ASHUO-claude-skills

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

Testing & QAIn 2 lists

Docs

9

thechandanbhagat/claude-skills

Generate documentation, API docs, README files, and code comments. Use for creating or improving project documentation.

Writing & Content

Rpk Topic

9

redpanda-data/skills

Manage Redpanda topics and produce or consume records from the CLI with the `rpk topic` command group, and look up topic settings in the Redpanda docs. Use when creating, altering, trimming, or deleting topics, inspecting storage with describe-storage, or producing and consuming records with rpk. For Cloud login and profile setup, see /redpanda:rpk-cloud, and for Schema Registry subjects and schemas, see /redpanda:rpk-registry.

Writing & Content

Project Bro

9

ydnikolaev/antigravity-factory

Your project awareness buddy. Knows current state, reads docs, analyzes code, answers "where are we?" questions. Activate with "bro" or "project-bro".

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.