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

skill-conventions — правило для Claude Code: обзор и установка

Правило skill-conventions задаёт стандарты разработки скиллов: разделяет ручной и автоматический запуск, фиксирует семантику записи данных и правила синхронизации роутера.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/skill-conventions.mdc
Открыть на GitHub

Что делает skill-conventions

Правило внедряет строгие соглашения для всех скиллов внутри воркфлоу. Главное требование — однозначный выбор режима вызова: либо ручной с флагом user-invocable: true для действий с побочными эффектами, либо автозапуск агентом по точному описанию задачи. Если условия срабатывания нельзя сформулировать в одном предложении, скилл обязан оставаться ручным.

Для работы с хранилищем фактов, заметок и истории правило вводит три операции: add с адресацией по содержимому и апсертом, точечный update по найденному идентификатору и append для последовательных логов. Скилл, который при повторном запуске плодит дубликаты вместо обновления записи, считается сломанным.

Жизненный цикл навыка делится на три корзины: черновик, релиз и устаревший. Перед добавлением в роутер skills/skill-router/SKILL.md файл должен пройти проверку через режим deslop: текст умещается на один экран, дублирующих инструкций нет, а описание автозапуска чётко откалибровано.

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

  • Исключить случайные срабатывания скиллов от посторонних фраз в промпте
  • Предотвратить дублирование записей при повторном выполнении команд
  • Разграничить ручные сценарии и автономные навыки агента
  • Поддерживать реестр навыков в актуальном состоянии

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

  • Проверь этот файл навыка на соответствие skill-conventions перед релизом
  • Помоги переписать описание скилла, чтобы агент вызывал его только при поиске багов
  • Определи семантику записи для сохранения итогов сессии: add, update или append?

Как установить skill-conventions

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

.cursor/rules/skill-conventions.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о skill-conventions

Как установить skill-conventions в Claude Code?

Подключите маркетплейс командой /plugin marketplace add rohitg00/pro-workflow, затем установите плагин вызовом /plugin install pro-workflow@pro-workflow. Также можно сохранить файл в .claude/rules/skill-conventions.md.

Что делает правило skill-conventions?

Оно следит за архитектурой навыков: проверяет режим запуска, требует защиты от дублирования при повторной записи данных и обязывает обновлять skills/skill-router/SKILL.md при любых изменениях.

В чём разница между ручным и автоматическим запуском?

Ручной запуск помечается user-invocable: true и применяется для ритуалов или действий с побочными эффектами. Автоматические скиллы флага не имеют, поэтому их описание должно точно очерчивать задачу, чтобы агент не запускал их по случайным фразам.

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

skill-conventions.mdc · MIT
---
description: Conventions every pro-workflow skill follows - invocation intent, write semantics, buckets, and sync. A skill that gets these wrong misfires, duplicates state, or hides from the people who need it.
globs:
alwaysApply: true
---

# Skill Conventions

## Invocation intent - declare one

Every skill is either human-run or auto-triggered. Getting this wrong is the
most common failure: a deliberate skill that auto-fires interrupts, an
auto-skill with a vague description never fires.

- **Human-run** - deliberate, side-effectful, or a session ritual. Set
  `user-invocable: true`. The user reaches for it on purpose; it should not
  fire from a stray phrase. Examples: `wrap-up`, `safe-mode`, `agent-teams`,
  `plan-interrogate`, `auto-setup`, `tdd`, `domain-modeling`.
- **Auto-triggered** - the agent should reach for it from the prompt. No
  `user-invocable` flag; instead the description must be precise enough to
  fire on the right task and stay silent otherwise. A description that is
  vague under-fires; one that over-claims interrupts. Examples: `deslop`,
  `module-map`, `replay-learnings`, `bug-capture`, `wiki-query`.

Pick the mode from what the skill does, not from habit. If you cannot say in
one sentence when it should fire on its own, it is human-run. The full
per-skill classification lives in [`skills/skill-router/SKILL.md`](../skills/skill-router/SKILL.md).

## Write semantics - add vs update vs append

A skill that changes stored state (learnings, wiki pages, handoffs, issues)
must be explicit about which operation it performs, and must be safe to run
twice.

- **add** - create a new record. Derive its identity from content, not a fresh
  random id, so re-running the same input does not duplicate. If a record with
  that identity exists, reinforce or update it instead of adding a twin.
- **update** - modify an existing record addressed by its identity. Never
  blind-overwrite a record you did not locate first.
- **append** - add to an ordered log or list (a session handoff, a research
  trail) where every entry is meant to persist in sequence. Appends accrete;
  they never replace.

Rule of thumb: re-importable or re-derivable input uses content-addressed
`add` with upsert. One-off events use `append`. Corrections to an existing
fact use `update`. A skill that re-runs and duplicates its own output is
broken, not chatty.

## Buckets

Keep the promoted set clean. A skill is either shipped or it is not.

- **Promoted** - listed in the router, ready to use, carries a clear
  invocation intent. Only promoted skills appear in `skill-router`.
- **Draft** - work in progress, not yet in the router. Do not promote until
  it has a stable invocation intent and passes `deslop` skill-file mode.
- **Deprecated** - superseded; leave a one-line pointer to the replacement and
  drop it from the router.

## Sync obligations

- **Router** - adding, renaming, removing, or re-scoping a promoted skill
  updates `skills/skill-router/SKILL.md` in the same change.
- **Description** - the description is the auto-trigger surface. When behavior
  changes, re-tune it so it still fires on the right prompt.
- **Quality** - run `deslop` skill-file mode before promoting: no stale lines,
  no bloat past one screen, no dead sentences, no instruction stated twice, a
  clear anchor concept, and a declared invocation intent.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →
gstack garrytan Скилл gstack для Claude Code подбирает под запрос один из скиллов набора: планирование, ревью, QA, релиз, документация, безопасность, дизайн. CX Codex +1 24 900установок gsd-next open-gsd Скилл gsd-next для Claude Code и Codex определяет текущее состояние проекта и предлагает меню подходящих следующих действий. Запускается как стартовая точка в рабочих процессах GSD. CX Codex +1 558установок start ulpi-io Скилл start для Claude Code маршрутизирует новые задачи: выбирает профильный скилл, оценивает необходимость субагента и определяет минимальный контекст перед правками. CX Codex +1 152установок paperthin LilMGenius Принимает пользовательский запрос через команду /paperthin и без изменений передаёт его в маршрутизатор re0-workflow. CX Codex +1 120установок 04-skill-generate AI-Driven Dev Скилл 04-skill-generate для Claude Code создаёт маршрутизируемые скиллы для ИИ-инструментов проекта по этапам планирования и валидации. Превращает рабочий процесс в скилл или переписывает существующий. CX Codex +1 ★ 571звёзд репо abi-and-calling-conventions mohitmishra786 Скилл abi-and-calling-conventions для Claude Code, Codex, Cursor и других агентов, который объясняет правила ABI: передачу аргументов, регистры, выравнивание стека в System V AMD64, ARM AAPCS и RISC-V psABI. CX Codex +1 442установок

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

Весь набор →
domain-modeling Скилл domain-modeling собирает общий словарь предметной области и границы контекстов до написания кода, чтобы агент не пересказывал понятия своими словами. На выходе — CONTEXT.md и записи решений. CX Codex +1 ★ 2 966звёзд репо llm-gate Скилл llm-gate настраивает хуки типа prompt и agent в Claude Code. Помогает проверять коммиты, блокировать опасные команды и утечки ключей до вызова инструментов. CX Codex +1 ★ 2 966звёзд репо cost-tracker Скилл cost-tracker помогает следить за стоимостью сессии Claude Code, задавать бюджетные ориентиры и находить источники лишних расходов. Пригодится при работе над задачами в нескольких сессиях. CX Codex +1 ★ 2 966звёзд репо reviewer Субагент reviewer, который проверяет код построчно, читая реальные файлы и цитируя ошибки прямо из текста. Работает перед коммитом, при ревью PR и после крупных изменений. CX Codex ★ 2 966звёзд репо plan-interrogate Скилл plan-interrogate для Claude Code проверяет план до начала разработки: разбирает решения по зависимостям и задаёт по одному вопросу за раз, закрывая спорные места в дизайне. CX Codex +1 ★ 2 966звёзд репо bug-capture Скилл bug-capture для Claude Code превращает сообщение о дефекте в GitHub issue на языке проекта. Запускается после описания бага, QA-проверки или просьбы оформить задачу. CX Codex +1 ★ 2 966звёзд репо context-optimizer Скилл context-optimizer оптимизирует расход токенов и очищает контекст в сессиях Claude Code. Помогает, когда агент начинает тормозить или исчерпывается бюджет. CX Codex +1 ★ 2 966звёзд репо deslop deslop вычищает лишний код из изменений текущей ветки и проверяет качество файлов SKILL.md. Запустите его перед коммитом или при ревью скилла. CX Codex +1 ★ 2 966звёзд репо

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

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