# Продвинутая настройка Skills для Claude

Хороший skill - это не один файл с правилами "пиши красиво". Это примеры, антипримеры, ссылки на контекст, скрипты, ограничения и понятный результат, к которому агент должен прийти.

карточка 1 — моно-метка «», заголовок «https://code.claude.com/docs/en/skills», описание «Официальная документация Claude Code Skills», кнопка «»; карточка 2 — моно-метка «», заголовок «https://support.claude.com/en/articles/12512198-how-to-create-custom-skills», описание «Help Center», кнопка «»; карточка 3 — моно-метка «», заголовок «https://github.com/anthropics/skills», описание «Примеры Anthropic Skills», кнопка «»

## 1. Выбери повторяемую задачу

Skill нужен там, где ты постоянно повторяешь один и тот же процесс:

писать посты в одном стиле, собирать чек-листы к рилсам, делать ревью кода, превращать транскрипты в сценарии, готовить PDF/презентации, проверять лендинги перед публикацией

> Не делай skill "для всего". Один skill — один повторяемый workflow.

## 2. Создай правильную структуру

врезка-пара: левый callout — метка `// Для личного использования`, текст «~/.claude/skills/my-skill/SKILL.md»; правый callout — метка `// Для проекта`, текст «.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. Дай цель, а не микроменеджмент

врезка-пара: левый callout — метка `// Плохой вариант`, текст «Сначала напиши 1 фразу, потом 2 абзаца, потом 5 пунктов, в каждом пункте...»; правый callout — метка `// Лучше`, текст «Цель: человек должен понять, зачем ему материал, и захотеть забрать его по кодовому слову. Ограничения: не повторять сценарий, не дублировать обложку, не писать воду. Критерии качества: описание цепляет с первой строки, чек-лист можно использовать без видео.»

## 7. Добавь проверку результата

В конце skill должен сам себя проверять:

- [ ] не повторяет ли описание начало ролика
- [ ] есть ли кодовое слово
- [ ] понятно ли, что человек получает
- [ ] достаточно ли чек-лист полезный
- [ ] есть ли ссылки на упомянутые инструменты
- [ ] нет ли выдуманных фактов
- [ ] подходит ли первая строка под Instagram

## 8. Обновляй skill после ошибок

Каждая ошибка агента — это материал для улучшения skill.

Если Claude снова написал описание как транскрипцию - добавь это в антипримеры., Если забыл ссылку на GitHub - добавь отдельный пункт проверки., Если первая строка слабая - добавь 5 примеров сильных первых строк.

---

Источник: https://localhost:3000/m/prodvinutaya-nastrojka-skills-dlya-claude