Чек-лист
кодовое словоКлод
Продвинутая настройка Skills для Claude
Хороший skill - это не один файл с правилами "пиши красиво". Это примеры, антипримеры, ссылки на контекст, скрипты, ограничения и понятный результат, к которому агент должен прийти.
Содержание8 глав
https://code.claude.com/docs/en/skillsОфициальная документация Claude Code Skills
https://support.claude.com/en/articles/12512198-how-to-create-custom-skillsHelp Center
https://github.com/anthropics/skillsПримеры Anthropic Skills
1. Выбери повторяемую задачу
Skill нужен там, где ты постоянно повторяешь один и тот же процесс:
писать посты в одном стиле
собирать чек-листы к рилсам
делать ревью кода
превращать транскрипты в сценарии
готовить PDF/презентации
проверять лендинги перед публикацией
Не делай skill "для всего". Один skill — один повторяемый workflow.
2. Создай правильную структуру
Для личного использования
~/.claude/skills/my-skill/SKILL.md
Для проекта
.claude/skills/my-skill/SKILL.md
Продвинутая структура
my-skill/
├── SKILL.md
├── examples/
│ ├── good-output.md
│ └── bad-output.md
├── references/
│ ├── tone-of-voice.md
│ └── project-context.md
├── templates/
│ └── output-template.md
└── scripts/
└── validate.sh
3. В SKILL.md не писать простыню
Внутри SKILL.md должно быть:
когда использовать skill
какая цель результата
какие файлы подтянуть при необходимости
какие ошибки не повторять
какой формат ответа нужен
как проверить качество
Пример основы
---
name: reels-checklist
description: Use when turning a short video transcript into an Instagram description and a useful lead magnet checklist.
---
# Reels Checklist
## Goal
Turn the transcript into a short Instagram description and a practical checklist.
## Rules
- Do not rewrite the transcript word for word.
- First line must hook attention.
- Checklist must be useful without watching the video.
- If a tool, repo, or link is promised, verify the source.
## Output
1. Code word
2. Description
3. Checklist title
4. Checklist content
5. Manual checks
4. Добавь примеры и антипримеры
Это главный пункт из ролика: Claude лучше учится на конкретных примерах.
В examples/good-output.md положи 2-3 сильных результата.
В examples/bad-output.md положи типичные ошибки:
описание повторяет сценарий
первая строка дублирует обложку
чек-лист слишком короткий
нет ссылки на обещанный GitHub
публичный ответ звучит как робот
агент выдумал инструмент
который не проверил
5. Подключи реальный контекст
Skill может ссылаться на материалы, которые Claude подтянет только когда они нужны:
старые транскрипции роликов
примеры описаний
которые понравились
список запрещенных формулировок
стиль автора
шаблон воронки
структура чек-листа
ссылки на репозитории и источники
Пример в SKILL.md
## Additional resources
- For tone of voice, read references/tone-of-voice.md.
- For output format, use templates/output-template.md.
- For examples, compare against examples/good-output.md and examples/bad-output.md.
6. Дай цель, а не микроменеджмент
Плохой вариант
Сначала напиши 1 фразу, потом 2 абзаца, потом 5 пунктов, в каждом пункте...
Лучше
Цель: человек должен понять, зачем ему материал, и захотеть забрать его по кодовому слову. Ограничения: не повторять сценарий, не дублировать обложку, не писать воду. Критерии качества: описание цепляет с первой строки, чек-лист можно использовать без видео.
7. Добавь проверку результата
В конце skill должен сам себя проверять:
- не повторяет ли описание начало ролика
- есть ли кодовое слово
- понятно ли, что человек получает
- достаточно ли чек-лист полезный
- есть ли ссылки на упомянутые инструменты
- нет ли выдуманных фактов
- подходит ли первая строка под Instagram
8. Обновляй skill после ошибок
Каждая ошибка агента — это материал для улучшения skill.
Если Claude снова написал описание как транскрипцию - добавь это в антипримеры., Если забыл ссылку на GitHub - добавь отдельный пункт проверки., Если первая строка слабая - добавь 5 примеров сильных первых строк.
