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

skill-writing-best-practices — скилл для Claude Code: установка

Скилл skill-writing-best-practices задаёт стандарты оформления и структуры скиллов для ИИ-агентов. Пригодится при упаковке соглашений по коду и ревью файлов в папке skills/.

MIT 176 установок ★ 92 обновлён 2026-02-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sergiodxa/agent-skills --skill skill-writing-best-practices -a claude-code
Открыть на GitHub

Что делает skill-writing-best-practices

Скилл описывает шесть правил создания инструкций для ИИ-агентов. Они сгруппированы в три категории: структура, содержание и стиль. Агент обращается к этим правилам автоматически при создании или редактировании файлов в директории skills/.

В основе лежит разделение на сводный файл SKILL.md и каталог rules/ с детальными описаниями. Каждое правило требует обязательных примеров кода, практических выводов и понятного обоснования. Стандарт запрещает абстрактные формулировки и штампы, требуя естественного стиля технической документации.

Этот подход обязывает делить инструкции на множество отдельных файлов с блоками frontmatter.

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

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

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

  • Создай новый скилл для проверки стилей в папке skills/, следуя skill-writing-best-practices
  • Проверь оформление правил в skills/backend-best-practices/ на соответствие skill-writing-best-practices

Как установить skill-writing-best-practices

1Через Skills CLI (Vercel)

npx skills add sergiodxa/agent-skills --skill skill-writing-best-practices -a claude-code

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

~/.claude/skills/skill-writing-best-practices/SKILL.md

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

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

Вопросы о skill-writing-best-practices

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

Выполните в терминале команду: npx skills add sergiodxa/agent-skills --skill skill-writing-best-practices -a claude-code.

Когда срабатывает этот скилл?

Инструкции активируются при создании или правке любых файлов внутри каталога skills/ в репозитории.

Какую структуру каталогов задаёт скилл?

Каждый скилл оформляется в виде корневого файла SKILL.md с общим обзором и вложенной папки rules/ с отдельными markdown-файлами под каждое правило.

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

SKILL.md · MIT
---
name: skill-writing-best-practices
description: Guidelines for creating AI agent skills. Use when writing new skills, documenting coding patterns, or reviewing skill files. Triggers when creating or modifying files in the skills/ directory.
---

# Skill Writing Best Practices

Patterns for creating effective AI agent skills that capture coding conventions and best practices. Contains 6 rules covering structure, content, and writing style.

## When to Apply

Reference these guidelines when:

- Creating a new skill from scratch
- Extracting patterns from an existing codebase
- Reviewing or improving existing skills
- Converting documentation into skill format

## Rules Summary

### Structure (HIGH)

#### skill-directory-structure - @rules/skill-directory-structure.md

Every skill has a SKILL.md and a rules/ directory.

```
skills/
└── topic-best-practices/
    ├── SKILL.md              # Main summary with all rules
    └── rules/
        ├── rule-name.md      # Detailed individual rules
        └── another-rule.md
```

#### skill-md-structure - @rules/skill-md-structure.md

SKILL.md has frontmatter, overview, and condensed rule summaries.

```markdown
---
name: topic-best-practices
description: When to use this skill.
---

# Topic Best Practices

Brief intro. Contains N rules across M categories.

## When to Apply

- Situation 1
- Situation 2

## Rules Summary

### Category (IMPACT)

#### rule-name - @rules/rule-name.md

One sentence. Code example.
```

#### rule-file-structure - @rules/rule-file-structure.md

Each rule file has frontmatter, explanation, examples, and takeaways.

```markdown
---
title: Rule Title
impact: HIGH
tags: [relevant, tags]
---

# Rule Title

What to do and why.

## Why

- Benefit 1
- Benefit 2

## Pattern

\`\`\`ruby
# Bad
bad_code

# Good
good_code
\`\`\`

## Rules

1. Takeaway 1
2. Takeaway 2
```

### Content (HIGH)

#### concrete-examples - @rules/concrete-examples.md

Every rule needs code examples. Abstract advice is hard to apply.

```markdown
# Bad: Too abstract
"Keep your code organized."

# Good: Concrete
"Place concerns in `app/models/model_name/` not `app/models/concerns/`."

\`\`\`ruby
# Shows exactly what to do
app/models/card/closeable.rb
\`\`\`
```

#### explain-why - @rules/explain-why.md

Don't just show what. Explain why it matters.

```markdown
## Why

- **Testability**: Sync method can be tested without job infrastructure
- **Flexibility**: Callers choose sync or async based on context
- **Clarity**: The `_later` suffix makes async behavior explicit
```

### Style (MEDIUM)

#### writing-style - @rules/writing-style.md

Write naturally. Avoid AI-isms and excessive formatting.

```markdown
# Bad
---
Here is an overview of the key points:
---

# Good
Group related rules by category. Each rule gets a one-sentence
description and a short code example.
```

## Philosophy

Good skills are:

1. **Concrete** - Every rule has code examples
2. **Reasoned** - Explains why, not just what
3. **Scannable** - Easy to find relevant rules quickly
4. **Honest** - Shows when NOT to use a pattern
5. **Natural** - Written like documentation, not AI output

© sergiodxa · MIT · sergiodxa/agent-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
jupyter-notebook-writing zc277584121 Скилл jupyter-notebook-writing для Claude Code редактирует Jupyter-ноутбуки через Markdown вместо JSON. Файл .md конвертируется в .ipynb через jupyter-switch. CX Codex +1 3 900установок bmad-shard-pro bmad-code-org Скилл bmad-shard-pro для Claude Code делит длинные документы на компактные части для удобного чтения агентом. Применяется при работе с объемными спецификациями, PRD и техническими описаниями. CX Codex +1 4 200установок markdown-mermaid-writing K-Dense-AI Скилл markdown-mermaid-writing пишет научную документацию в Markdown и рисует структурные диаграммы Mermaid: схемы процессов, связей, таймлайны. Полезен, когда отчёт или README должны лежать в git как текст. CX Codex +1 2 300установок writing-adrs pandoscope Скилл writing-adrs для Claude Code задаёт формат, нумерацию и критерии Architecture Decision Record. Записывает решения по архитектуре, когда они трудны на откат, удивляют без контекста и выбраны из вариантов. CX Codex +1 1 700установок book-writing-workspace yamapan (https://github.com/aktsmm) Скилл book-writing-workspace собирает в репозитории рабочее место для технической книги: папки разделов, документ о читателе, файлы агентов и порядок рецензирования. CX Codex +1 244установок writing-guidelines vercel Скилл writing-guidelines для ревью документации и прозы по письменному гайдлайну. Возвращает замечания с номерами строк, чтобы правки не искать по всему файлу вручную. CX Codex +1 133 400установок

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

Весь набор →
frontend-react-best-practices Скилл frontend-react-best-practices с 33 правилами по оптимизации React: меньше лишних ре-рендеров, аккуратнее бандл, чище композиция компонентов. Пригодится при написании и рефакторинге компонентов. CX Codex +1 1 200установок frontend-accessibility-best-practices Скилл frontend-accessibility-best-practices для Claude Code содержит стандарты WCAG для React-компонентов. Включается при создании UI, форм и интерактивных элементов, а также при проверке доступности кода. CX Codex +1 926установок frontend-tailwind-best-practices Скилл frontend-tailwind-best-practices для Claude Code и Codex: 10 правил Tailwind CSS — стеки, отступы через gap, тёмная тема и слияние классов. Контролирует стили компонентов и предотвращает поломку вёрстки. CX Codex +1 470установок frontend-react-router-best-practices Скилл frontend-react-router-best-practices для Claude Code задаёт архитектурные правила React Router: переносит загрузку данных в loader и помогает писать параллельные запросы и безопасные формы. CX Codex +1 406установок frontend-js-best-practices Скилл frontend-js-best-practices задаёт 17 правил оптимизации и стиля для JavaScript и TypeScript. Помогает писать быстрые циклы, избегать лишних аллокаций и убирать мутации массивов при рефакторинге. CX Codex +1 341установок ruby-on-rails-best-practices Скилл ruby-on-rails-best-practices для Claude Code описывает 16 правил архитектуры Rails из практики Basecamp: модели, тонкие контроллеры, фоновые задачи и Turbo Streams. CX Codex +1 283установок frontend-async-best-practices Скилл frontend-async-best-practices для Claude Code помогает устранять waterfalls: заменяет последовательные ожидания независимых запросов параллельными. CX Codex +1 228установок frontend-internationalization-best-practices Скилл frontend-internationalization-best-practices для Claude Code описывает настройку i18n в React Router с remix-i18next: middleware, SSR-синхронизацию и словари. CX Codex +1 195установок

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

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