раздел 05 · подстраница 2

Создаём свой skill за 10 минут

Соберём /blog-post-writer - skill, который пишет посты в вашем стиле, анализируя архив ранее опубликованных текстов. От пустой папки до рабочего /blog-post-writer "тема".

Зачем именно такой пример

Это типовая задача: у вас есть Telegram-канал или блог, вы хотите, чтобы Claude писал в вашей манере, а не дефолтным "ИИ-голосом". Решение - skill, который сначала читает ваш архив, формирует "voice profile", потом пишет.

Шаг 1. Создать директорию

mkdir -p ~/.claude/skills/blog-post-writer
cd ~/.claude/skills/blog-post-writer

Подложить рядом архив примеров:

mkdir voice-samples
# скопировать 10-20 ваших постов как .md или .txt
cp ~/Documents/posts/*.md voice-samples/

Шаг 2. Написать SKILL.md

---
name: blog-post-writer
description: Написать пост в личном стиле пользователя, анализируя его архив постов. Использовать когда пользователь просит "напиши пост", "сделай telegram-пост", "сгенерируй текст в моём стиле".
tools: Read, Write
model: opus
---

# Blog Post Writer

Пишет посты в личной манере пользователя.

## Алгоритм

1. Прочитать 5-7 случайных файлов из `voice-samples/`.
2. Выделить признаки стиля: длина предложений, лексика, ритм, табу-слова, типичные структуры.
3. Сформировать voice-profile в 1 абзац - держать его в голове при написании.
4. Уточнить у пользователя:
   - Тема поста (если не указана).
   - Длина (короткий 500 знаков / средний 1500 / лонгрид 4000+).
   - Платформа (Telegram / LinkedIn / блог).
5. Написать пост.
6. Перечитать: убрать клише, ИИ-обороты, em-dash. Дефис вместо тире.

## Правила стиля по умолчанию

- Короткие абзацы, разный ритм предложений.
- Без "Важно отметить", "В современном мире", "Давайте разберёмся".
- Без слов: погружение, трансформация, экосистема, прорывной, бесшовный.
- Без конструкций "Не просто X, а Y".
- Не заканчивать вдохновляющим выводом.

## Формат вывода

Сохранить в `./drafts/YYYY-MM-DD-<slug>.md`. Если папки нет - создать.

Шаг 3. Запустить и проверить

cd ~/projects/my-blog
claude

В CLI:

> /blog-post-writer "Почему я выбираю CLI вместо IDE-плагина"

Claude:

  1. Прочитает несколько файлов из voice-samples/.
  2. Уточнит длину и платформу (если не задали).
  3. Напишет черновик и сохранит в drafts/.
скриншот
Вызов /blog-post-writer в CLI: Claude читает архив, потом пишет
Где взять: docs.claude.com/en/docs/claude-code/skills#usage

Шаг 4. Итерации

Skills не пишутся с первого раза. Цикл:

  1. Запустить - посмотреть, что получилось.
  2. Найти что не так (плохо ловит стиль, не уточняет длину, кладёт не туда).
  3. Открыть ~/.claude/skills/blog-post-writer/SKILL.md и поправить инструкцию.
  4. Повторить.

Обычно 3-5 итераций - и skill работает стабильно.

Шаг 5. Закоммитить (если проектный)

Если skill полезен только в одном проекте - переместите в проектную папку:

mv ~/.claude/skills/blog-post-writer .claude/skills/
git add .claude/skills/blog-post-writer
git commit -m "Add blog-post-writer skill"

Теперь коллеги, у которых тот же репозиторий, тоже получат /blog-post-writer.

Чек-лист готового skill

  • [ ] description содержит явные триггеры ("когда пользователь говорит X").
  • [ ] Алгоритм прописан шагами, не общими словами.
  • [ ] Указано, куда сохранять артефакты.
  • [ ] Перечислены анти-правила (что НЕ делать).
  • [ ] Прогнали 3-5 раз - стабильно работает.

Антипаттерны

  • Описать процесс одним абзацем "напиши пост в моём стиле" - не сработает, Claude не поймёт что делать.
  • Не дать примеров стиля - "ваш стиль" будет среднестатистическим.
  • Скопировать SKILL.md от кого-то и не адаптировать триггеры - skill будет дёргаться не вовремя.

Полезные ссылки