К основному содержанию
скилл CX Codex

writing-great-skills — скилл для Claude Code

Скилл writing-great-skills для Claude Code создаёт, проверяет и сокращает SKILL.md, чтобы агент следовал понятному процессу. Помогает разбирать нестабильную работу навыка и избыточные инструкции.

MIT ★ 540 обновлён 2026-07-14

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add trailofbits/skills-curated
/plugin install productivity@skills-curated
Открыть на GitHub

Что делает writing-great-skills

writing-great-skills — справочник для работы над скиллами: он помогает выбрать, что поместить в инструкции, как описать условия запуска и где хранить справочные материалы. Отдельно разбирает критерии завершения шагов, разделение скилла на части и удаление лишнего текста.

Скилл настроен для ручного вызова: в его настройках указано disable-model-invocation: true. Значит, агент не запускает его сам; нужно попросить применить writing-great-skills. Это важно, если вы рассчитываете на автоматический запуск по описанию.

Для работы он может читать и искать файлы, а также редактировать и создавать их с помощью Read, Grep, Glob, Edit и Write. Справочные определения вынесены в GLOSSARY.md; советы по упаковке плагинов этот скилл не охватывает.

Какие задачи решает

  • спроектировать структуру нового SKILL.md
  • найти причины нестабильного запуска скилла
  • разделить инструкции и справочные материалы
  • сократить разросшееся описание скилла

Примеры запросов агенту

  • Примени writing-great-skills и помоги составить структуру нового SKILL.md.
  • Проверь мой скилл: агент пропускает шаги и завершает работу раньше времени.
  • Сократи этот SKILL.md, убрав повторы и лишние предложения.

Как установить writing-great-skills

1Через маркетплейс плагинов

/plugin marketplace add trailofbits/skills-curated
/plugin install productivity@skills-curated

Команда ставит плагин productivity целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add trailofbits/skills-curated --skill writing-great-skills -a claude-code

3Вручную: положить файлы

~/.claude/skills/writing-great-skills/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/writing-great-skills/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о writing-great-skills

Как установить writing-great-skills в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add trailofbits/skills-curated, затем установите плагин командой /plugin install productivity@skills-curated.

Что делает writing-great-skills?

Помогает проектировать и редактировать скиллы: описывать запуск, выстраивать инструкции и справочные материалы, задавать проверяемое завершение работы и убирать лишний текст.

Может ли writing-great-skills запускаться автоматически?

Нет. В настройках стоит disable-model-invocation: true, поэтому скилл нужно вызывать вручную.

Исходный текст

SKILL.md · MIT
---
name: writing-great-skills
description: >-
  Reference for writing and editing agent skills well — the vocabulary and
  principles that make a skill predictable. Consult when authoring, reviewing,
  or pruning a SKILL.md.
disable-model-invocation: true
allowed-tools:
  - Read
  - Grep
  - Glob
  - Edit
  - Write
---

# Writing Great 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 lever below serves it.

**Bold terms** are defined in [`GLOSSARY.md`]({baseDir}/references/GLOSSARY.md); look them up there for the full meaning.

## When to Use

- Writing a new skill and deciding how to structure, word, and scope it
- Reviewing or editing an existing skill that fires unreliably, runs
  inconsistently, or has grown bloated
- Diagnosing a skill failure mode: the agent rushes steps, ignores reference
  material, or triggers the wrong skill

## When NOT to Use

- General prompt engineering for one-off prompts — this reference is about
  reusable skills, where predictability across runs is the goal
- Questions about skill/plugin packaging mechanics (directory layout,
  manifest fields); consult the platform's plugin documentation instead

## 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.

When user-invoked skills multiply past what you can remember, that piled-up cognitive load is cured by a **router skill**: one user-invoked skill that names the others and when to reach for each.

## Writing the description

A model-invoked **description** does two jobs — state what the skill is, and list the **branches** that should trigger it. Every word increases **context load**, so a description earns even harder pruning than the body:

- **Front-load the skill's leading word** — the description is where it does its invocation work.
- **One trigger per branch.** Synonyms that rename a single branch are **duplication** — "build features using TDD … asks for test-first development" is one branch written twice. Collapse them; keep only genuinely distinct branches.
- **Cut identity that's already in the body.** Keep the description to triggers, plus any "when another skill needs…" reach clause.

## Information hierarchy

A skill is built from two content types — **steps** and **reference** — that mix freely: a skill can be all steps, all reference, or both. The core decision is which to use and where each sits on the **information hierarchy**, a ladder ranked by how immediately the agent needs the material:

1. **In-skill step** — an ordered action in `SKILL.md`, the primary tier: what the agent does, in order. Each step ends on a **completion criterion**, the condition that tells the agent the work is done. Make it _checkable_ (can the agent tell done from not-done?) and, where it matters, _exhaustive_ ("every modified model accounted for", not "produce a change list") — a vague criterion invites **premature completion**.
2. **In-skill reference** — a definition, rule, or fact in `SKILL.md`, consulted on demand. Often a legitimately flat peer-set (every rule of a review on one rung) — a fine arrangement, not a smell. _This skill is all reference._
3. **External reference** — reference pushed out of `SKILL.md` into a separate file, reached by a **context pointer**, loaded only when the pointer fires. (Spans _disclosed_ reference — a sibling file like `GLOSSARY.md`, still part of the skill — through fully **external reference** that lives outside the skill system and any skill can point at.)

A demanding completion criterion drives thorough **legwork** — the digging the agent does within the work — whether the skill has steps or not, since "every rule applied" binds flat reference just as "every step done" binds a sequence.

Push too little down and the top bloats; push too much and you hide material the agent actually needs. That tension is the whole decision.

**Progressive disclosure** is the move down the ladder — out of `SKILL.md` into a linked file — so the top stays legible. Mechanics: a linked `.md` file in the skill folder, named for what it holds (this skill discloses its full definitions to `GLOSSARY.md`). Some skills are used in more than one way, and each distinct way is a **branch** — different runs taking different paths through the skill. Branching is the cleanest disclosure test: inline what every branch needs, and push behind a pointer what only some branches reach. A **context pointer**'s _wording_, not its target, decides when and how reliably the agent reaches the material.

Where the ladder decides _how far down_ a piece sits, **co-location** decides _what sits beside it_ once there: keep a concept's definition, rules, and caveats under one heading rather than scattered, so reading one part brings its neighbours with it.

## When to split

**Granularity** is how finely you divide skills, and each cut spends one of the two loads, so split only when the cut earns it. Two cuts:

- **By invocation** — split off a **model-invoked** skill when you have a distinct **leading word** that should trigger it on its own, or another skill must reach it. You pay **context load** for the new always-loaded **description**, so that independent reach has to be worth it.
- **By sequence** — split a run of **steps** when the steps still ahead (a step's **post-completion steps**) tempt the agent to rush the one in front of it (**premature completion**). Keeping them out of view encourages the agent to do more **legwork** on the current task.

## Pruning

Keep each meaning in a **single source of truth**: one authoritative place, so changing the behaviour is a one-place edit.

Check every line for **relevance**: does it still bear on what the skill does?

Then hunt **no-ops** sentence by sentence, not just line by line: run the no-op test on each sentence in isolation, and when one fails, delete the whole sentence rather than trim words from it. Be aggressive — most prose that fails should go, not be rewritten.

## Leading words

A **leading word** is a compact concept already living in the model's pretraining that the agent thinks with while running the skill (e.g. _lesson_, _fog of war_, _tracer bullets_). Repeated throughout the text (though not necessarily - a strong leading word might only be needed once), it accumulates a distributed definition and anchors a whole region of behaviour in the fewest tokens, by recruiting priors the model already holds.

It serves predictability twice. In the body it anchors _execution_: the agent reaches for the same behaviour every time the word appears. In the description it anchors _invocation_: when the same word lives in your prompts, docs, and code, the agent links that shared language to the skill and fires it more reliably.

Hunt for opportunities to refactor skills to use leading words. A triad spelled out at three sites (**duplication**), a description spending a sentence to gesture at one idea — each is a passage begging to **collapse** into a single token. Examples include:

- "fast, deterministic, low-overhead" -> _tight_ — one quality restated across a phase — into a single pretrained word (a _tight_ loop).
- "a loop you believe in" -> _red_ — converts a fuzzy gate into a binary observable state (the loop goes _red_ on the bug, or it doesn't).

You win twice over: fewer tokens, _and_ a sharper hook for the agent to hang its thinking on. Assume every skill is carrying restatements that leading words retire — go find them.

## Failure modes

Use these to diagnose issues the user may be having with the skill.

- **Premature completion** — ending a step before it's genuinely done, attention slipping to _being done_. Defence, in order: sharpen the completion criterion first (cheap, local); only if it is irreducibly fuzzy _and_ you observe the rush, hide the post-completion steps by splitting (the sequence cut).
- **Duplication** — the same meaning in more than one place. Costs maintenance and tokens, and inflates a meaning's prominence on the ladder past its real rank.
- **Sediment** — stale layers that settle because adding feels safe and removing feels risky. The default fate of any skill without a pruning discipline.
- **Sprawl** — a skill simply too long, even when every line is live and unique. Hurts readability and maintainability and wastes tokens. The cure is the ladder: disclose **reference** behind pointers, and split by **branch** or sequence so each path carries only what it needs.
- **No-op** — a line the model already obeys by default, so you pay load to say nothing. The test: does it change behaviour versus the default? A weak leading word (_be thorough_ when the agent is already thorough-ish) is a no-op; the fix is a stronger word (_relentless_), not a different technique.
- **Negation** — steering by prohibition backfires: _don't think of an elephant_ names the elephant and makes it more available, not less. Prompt the **positive** — state the target behaviour so the banned one is never spoken; keep a prohibition only as a hard guardrail you can't phrase positively, and even then pair it with what to do instead.

© Matt Pocock · MIT · trailofbits/skills-curated

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
open-knowledge-write-skill Inkeep Скилл open-knowledge-write-skill помогает агенту составить новый SKILL.md: выбрать область действия, оформить frontmatter и проверить, что скилл срабатывает в нужный момент. CX Codex +1 6 900установок skill-authoring grafana Скилл skill-authoring для Claude Code и других агентов: проверяет SKILL.md по четырём критериям рубрики CI-гейта grafana/skills. Ловит ошибки до ревью. CX Codex +1 4 300установок create-skill NeoLabHQ Скилл create-skill для Claude Code, Codex, Cursor и других агентов, который ведёт через процесс написания нового скилла по методике TDD. Сначала субагент проваливает тест без документа, потом скилл пишется под конкретные нарушения. CX Codex +1 1 300установок maplibre-skill-authoring maplibre Скилл maplibre-skill-authoring помогает превратить исследовательскую сессию по MapLibre в материал для нового или существующего скилла. Запускайте его, пока контекст задачи ещё открыт. CX Codex +1 229установок creating-skills fvadicamo Скилл creating-skills для Claude Code помогает создавать и обновлять скиллы, включая SKILL.md. Он подключается по запросу о структуре, правилах именования или настройке скилла. CX Codex +1 208установок skill-master itechmeat Скилл skill-master для Claude и других агентов: помогает писать, проверять и сравнивать Agent Skills по спецификации agentskills.io — от структуры папок до замеров срабатывания. CX Codex +1 161установок

Из того же набора51

Весь набор →
x-research Скилл x-research для Claude Code ищет свежие обсуждения в X, открывает треды и собирает источники в сводку. По ним можно узнать реакцию разработчиков на выпуск библиотеки или изменение API. CX Codex +1 ★ 540звёзд репо skill-extractor Скилл skill-extractor разбирает рабочую сессию и превращает найденное решение в скилл для Claude: причину ошибки, обходной путь, условия срабатывания. CX Codex +1 ★ 540звёзд репо openai-screenshot Скилл openai-screenshot для Claude Code делает снимки рабочего стола, активных окон и выбранных областей экрана. Агент визуально проверяет интерфейс по снимкам. CX Codex +1 ★ 540звёзд репо openai-develop-web-game Скилл openai-develop-web-game направляет агента при разработке браузерных игр на HTML и JavaScript через пошаговый цикл с тестами в Playwright. CX Codex +1 ★ 540звёзд репо import-skill Команда import-skill переносит скиллы из сторонних репозиториев GitHub в каталог плагинов Claude Code: скачивает дерево, адаптирует пути и разметку. CX Codex +1 ★ 540звёзд репо wooyun-legacy Скилл wooyun-legacy разбирает веб-уязвимости и логические бреши по методологии базы WooYun. Пригодится на пентестах, аудитах кода и проверке систем авторизации. CX Codex +1 ★ 540звёзд репо productivity Плагин productivity для Claude Code объединяет четыре скилла для повседневной работы с агентом: разбор планов, передачу сессии, обучение и написание скиллов. ★ 540звёзд репо security-awareness Плагин security-awareness обучает ассистента распознавать фишинг, проверять домены и защищать пароли с токенами при работе с почтой, браузером и хранилищами секретов. ★ 540звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой