Claude Skills · SKILL.md

Как собрать Claude Skills
под SEO и контент-завод

Q: Чем Claude Skills отличаются от обычного промпта

Промпт живёт в одном диалоге. Skill — в файле с паспортом `name`/`description`, подгружается по задаче и может тащить references и скрипты. Промпт Rembrandt на вечер; skill — должностная инструкция на месяц.

Q: Нужен ли Claude Code, чтобы пользоваться skills

Нет. Claude Code — удобный путь с папкой `.claude/skills/` и вызовом `/имя`. Тот же формат Agent Skills поддерживают и другие среды (Cursor, Codex, Gemini CLI и др.). Если Claude Code недоступен из РФ, собирайте библиотеку там, где у вас стабильный доступ, сохраняя канонический `SKILL.md`.

SKILL.md, установка в Claude Code и библиотека ролей вместо хаоса промптов

Читать в Telegram Maya Pro

Разовый промпт спасает один вечер. На второй день тон статьи «плывёт», в Telegram уезжает другой голос бренда, а SEO-чек-лист снова приходится диктовать с нуля. Claude Skills фиксируют роль один раз и вызывают её по триггеру.

Если вы собираете контент-завод — серию статей, постов и FAQ под поиск и нейросети — без библиотеки skills каждый выпуск снова упирается в ручной контроль. Skill помнит запреты на клише, формат H2 и правило «человек перед публикацией».

SKILL.md Claude Code 5 ролей HITL

skills-pipeline.sh

# контент-завод на Agent Skills

$ wordstat-brief → seo-longread

$ geo-faq → telegram-post

$ qa-editor → человек → publish

Зачем Skills, если промпты уже «работают»

Разовый промпт спасает один вечер. На второй день тон статьи «плывёт», в Telegram уезжает другой голос бренда, а SEO-чек-лист снова приходится диктовать с нуля. Claude Skills решают другую задачу: зафиксировать роль один раз и вызывать её по триггеру — как готовую инструкцию для агента, а не как импровизацию в чате.

Коротко. Claude Skills (скиллы Claude) — это папки с файлом SKILL.md: Claude или совместимый агент подхватывает навык сам, когда задача совпадает с описанием. Так строится повторяемая автоматизация контента, а не «ещё один удачный диалог».

Если вы собираете контент-завод — серию статей, постов и FAQ под поиск и нейросети — без библиотеки skills каждый выпуск снова упирается в ручной контроль качества. Промпт «напиши SEO-статью» не помнит ваши запреты на клише, формат H2 и правило «человек перед публикацией». Skill помнит.

Где разовые инструкции ломают контент-пайплайн

Типичный сбой выглядит так. Маркетолог копирует «лучший промпт» из чата вчера, меняет тему и получает другой объём, другие заголовки и нулевой FAQ под ответы ИИ. Семантика из Wordstat живёт в Excel, а модель её не видит. Telegram-адаптация пишется «на глаз». Перед выкладкой никто не гоняет единый чек-лист — и в пост уезжает спорный факт.

Ещё больнее на масштабе: три человека в команде — три версии «фирменного стиля». Без общего skill каждый держит инструкцию у себя в заметках. Контент-завод превращается в ручной цех с разными стандартами на каждом станке.

Что даёт библиотека повторяемых ролей вместо чата с нуля

Библиотека Agent Skills даёт ролям имена: бриф, SEO-лонгрид, GEO/FAQ, Telegram, QA. Агент подгружает только нужный навык, а не всю «простыню» правил сразу. Вы тратите время на качество инструкции один раз — и экономите его на каждой следующей статье.

По рынку это уже не «игрушка для гиков». По данным АРИР, около 74% российских компаний готовы вкладываться в трафик через нейросети; примерно треть SEO/digital уже использует GEO/AEO, ещё 42% планируют до конца года. Skill с правилами прямых ответов и FAQ как раз закрывает этот спрос: контент должен быть удобен и человеку, и ИИ-выдаче.

Маркер: простыми словами. GEO (иногда рядом пишут AEO) — это когда текст пишут так, чтобы нейросети могли его процитировать: короткие прямые ответы, FAQ, чёткая структура. Не путать с «гео» как городом на карте.

ролей skills на старте завода

~500

строк — ориентир длины SKILL.md

уровня progressive disclosure

Skills, MCP, Projects и субагенты — кто за что отвечает

Путаница здесь стоит денег и нервов. Люди ставят MCP «потому что все ставят», хотя нужен был короткий чек-лист в SKILL.md. Или пихают всю методологию в Project и удивляются, что контекст раздувается на каждый чих.

Маркер: простыми словами. MCP — это «розетка» к внешним системам: Wordstat, WordPress, Telegram, таблицы. Skill не заменяет розетку: он учит агента, когда и как ей пользоваться и в каком формате ждать результат.

Когда хватает SKILL.md, а когда нужен инструмент или агент

Ориентир простой:

Нужно…	Что взять	Пример
Повторять один и тот же процесс	Skill (`SKILL.md`)	Структура SEO-статьи, тон Telegram, QA-чек-лист
Достать живые данные или действие снаружи	MCP	Снять частотность, опубликовать черновик
Держать фон проекта (бренд, офферы, табу)	Project / база знаний	Кто вы, для кого пишете, что нельзя обещать
Тяжёлую подзадачу без засорения основного чата	Субагент	Отдельный «исследователь» с своими правами

Маркер: простыми словами. Субагент — это «сотрудник внутри чата» с отдельным окном внимания: он делает кусок работы и возвращает итог, не засоряя основной диалог всей промежуточной перепиской.

Skill меняет поведение. MCP добавляет возможность. Project держит контекст «о чём мы». Субагент изолирует тяжёлую работу. Если задача — «каждый раз собирать FAQ по одним правилам», берите skill. Если задача — «забрать свежие ключи из Wordstat», нужен MCP (или ручной ввод брифа), а skill лишь описывает поля ТЗ.

Типичная путаница: один файл «на всё» vs разделение ролей

Антипаттерн новичка: один гигантский файл «наш контент-завод» на 80 экранов. Он и не skill, и не project — просто простыня. Агент либо игнорирует середину, либо тратит токены впустую.

Правильнее: короткие skills по ролям + тонкий фон бренда в Project + MCP только там, где реально нужны данные/публикация. В Claude Code skill может подсказать, когда звать инструмент или субагента — но не обязан сам быть этим инструментом.

Библиотека Skills · не hero

Progressive disclosure: ярлык → инструкция → references

Сцена справа — как агент видит библиотеку: пока skill «спит», в контексте почти только name и description. Совпадение с задачей подгружает тело SKILL.md, а тяжёлые примеры — только из references.

Метаданные — дёшевый «ярлык» на каждый skill (~100 токенов).
Тело SKILL.md — короткая роль: шаги, запреты, 1–2 образца.
references/ — чек-листы и длинные примеры по запросу, не простыней.

Дальше — анатомия frontmatter, лимиты описания и как собрать первые skills под бриф → SEO → Telegram → QA.

Редакционная схема, не скрин Claude Code: пять папок skills и три уровня подгрузки по мере задачи.

Анатомия SKILL.md: frontmatter, description и лимиты

Канон простой: skill — это папка, внутри обязателен файл SKILL.md. В начале файла — YAML-шапка (frontmatter), дальше — markdown-инструкция. Рядом по желанию лежат references/, scripts/, assets/.

Маркер: простыми словами. Frontmatter — это «паспорт» в начале файла между тремя дефисами ---. Туда пишут имя навыка и описание, по которому агент понимает: «меня сейчас нужно включить».

Обязательные поля: name и description. Имя — латиницей в нижнем регистре с дефисами, от 1 до 64 символов, совпадает с именем папки. Описание — до 1024 символов: что делает skill и когда его брать. Опционально встречаются license, compatibility, metadata, экспериментальное allowed-tools.

Тело файла лучше держать короче ~500 строк (ориентир документации — до ~5000 токенов). Ссылки на соседние файлы — относительные и на один уровень от SKILL.md: не стройте цепочки «reference ссылается на reference». Перед выкладкой в команду удобно прогнать валидацию из спецификации: skills-ref validate ./my-skill.

name и description как триггер автозагрузки

Пока skill «спит», агент видит в основном имя и description — порядка сотни токенов на навык. Полное тело подгружается, когда задача совпадает с описанием или когда вы вызываете skill явно (например /seo-longread в Claude Code).

Плохое description: «Помогает с документами». Хорошее: «Пишет SEO-лонгрид по брифу: H1–H3, антишаблон заголовков, объём 8–14k знаков, без воды. Использовать, когда нужна статья под Яндекс/Google и кластер ключей».

В description кладите глаголы и слова, которыми вы реально формулируете задачу: «лонгрид», «Wordstat», «Telegram-пост», «GEO FAQ». Иначе skill «молчит», а агент импровизирует.

Почему «простыня» в одном файле убивает качество ответа

После активации тело skill остаётся в окне внимания. Чем оно длиннее, тем меньше места под вашу тему, черновик и правки. Раздутый файл — это налог на каждый запуск.

Если хочется вложить 20 примеров статей — не пихайте их в SKILL.md. Оставьте в теле чек-лист и 1–2 коротких образца, остальное вынесите в references/.

Progressive disclosure: короткий skill → references/

Маркер: простыми словами. Progressive disclosure — «подгружай по мере надобности»: сначала ярлык (имя + описание), потом короткая инструкция, и только если надо — тяжёлые приложения из папки references/.

Три уровня:

Метаданные — всегда дёшево видны агенту.
Тело SKILL.md — при срабатывании.
references / scripts / assets — по запросу навыка.

Так библиотека растёт, а каждый отдельный запуск не тащит весь архив методологии.

Как добавить skill в Claude и Claude Code без сюрпризов

Формат Agent Skills открытый: один и тот же подход встречается в Claude, Claude Code, Cursor, Codex, Gemini CLI и ряде других агентов. Пути папок у платформ разные, идея одна — каталог skill с SKILL.md.

Важно для читателя из России. Claude и Claude Code — зарубежные продукты: доступ, оплата и лимиты зависят от вашего аккаунта и способа оплаты. Если Claude недоступен стабильно, тот же SKILL.md можно держать в Cursor (.cursor/skills/) или другом совместимом клиенте из списка на agentskills.io — и всё равно собирать контент-пайплайн. Платформенные «особые» поля frontmatter иногда игнорируются вне Claude Code: опирайтесь на канон name + description + тело.

Папка `.claude/skills/` и минимальный чек-лист запуска

В Claude Code личные навыки кладут в ~/.claude/skills/<имя>/SKILL.md, проектные — в .claude/skills/<имя>/SKILL.md внутри репозитория.

Шаг 1. Создайте папку, например .claude/skills/seo-longread/.

Шаг 2. Создайте файл SKILL.md с шапкой:

---
name: seo-longread
description: Пишет SEO-лонгрид по брифу для русскоязычной выдачи Яндекса и Google. Использовать при запросе статьи, структуры H2/H3, мета-тегов и объёма 8–14k знаков.
---

Шаг 3. Ниже шапки напишите цель, входы, шаги, примеры, запреты (шаблон — в следующем большом разделе).

Шаг 4. Перезапустите/откройте проект в Claude Code и вызовите /seo-longread или сформулируйте задачу словами из description.

Шаг 5. Проверьте на одной короткой теме: агент должен следовать чек-листу skill, а не «своему любимому» шаблону блога.

Признак успеха. В ответе видны ваши обязательные секции, запреты соблюдены, тон совпадает с примером из skill. При явном вызове /seo-longread навык точно в деле; при автозагрузке — в логе/поведении видно, что подтянулась нужная роль, а не соседняя.

Типичные ошибки новичка

Имя папки не совпадает с name → skill не находится. Решение: одинаковые seo-longread и там, и там.
Description без «когда использовать» → навык не триггерится. Решение: дописать сценарии и ключевые слова задач.
В файл попали API-ключи «на всякий случай» → риск утечки при шаринге репозитория. Решение: только плейсхолдеры, секреты вне skill.

Официальные детали путей и вызова — в документации Skills для Claude Code.

GitHub и marketplace: что ставить, а что править под себя

Скачать чужой skill с GitHub удобно как старт. Опасно — включать «как есть» в автопост и оплату рекламы. Перед установкой из незнакомого репозитория откройте все файлы: нет ли скриптов с сетью, нет ли внешних URL с риском подмены инструкций, нет ли просьб отправить данные «куда-то ещё».

Чужой SEO-skill почти всегда нужно локализовать: русские H2, Яндекс + Wordstat, ваши стоп-слова, ваш CTA. Marketplace и каталоги — источник идей, не готовая редакция вашего бренда.

Минимальный набор Skills под контент-завод

Вам не нужна «сотня скиллов маркетолога». На старте хватает пяти ролей. Ниже — рабочий минимум под SEO и контент-завод; имена можно оставить латиницей, как принято в name.

Skill	Задача	В теле SKILL.md	В references/
`wordstat-brief`	Бриф из семантики → ТЗ	Поля брифа, приоритет кластеров	Пример заполненного брифа
`seo-longread`	Статья H1–H3, объём, антивода	Чеклист секций, критерии готовности	Примеры сильных/слабых H2
`geo-faq`	FAQ и прямые ответы под ИИ	Правила «ответ в 1–2 фразах»	Образцы FAQ-блоков
`telegram-post`	Лонгрид → пост	Хук, тон, лимит длины, CTA	3–5 эталонных постов
`qa-editor`	Редактура до публикации	Факты, дубли, клише, E-E-A-T	Список запрещённых формулировок

Связка с инструментами: Wordstat, выкладка в WordPress или Telegram — через MCP или руками. Skill описывает формат. Публикацию без человека не отдавайте модели: для publish-сценариев в Claude Code используйте режим «только по явной команде» (в доках — опции вроде отключения автовызова), плюс ваш внутренний HITL.

Маркер: простыми словами. HITL значит «человек в контуре»: агент готовит черновик, человек жмёт «можно в прод». Без этого автопост легко утащит ошибку в канал.

Бриф и Wordstat → SEO-лонгрид

wordstat-brief принимает список ключей и отдаёт ТЗ: главный интент, кластеры, обязательные вопросы, чего не писать. seo-longread читает бриф и собирает статью: один H1, живые H2 без шаблонных хвостов, ключи без переспама, объём под конкуренцию.

Так вы отделяете «исследование спроса» от «написания текста» — как в нормальной редакции, только инструкции лежат в файлах, а не в голове штатного копирайтера.

GEO/FAQ-блок под ответы нейросетей

geo-faq отвечает за цитируемость: определение в одном абзаце, блок «Коротко», FAQ с прямыми ответами. По исследованию АРИР для GEO важны экспертность, структура и прямые ответы — ваш skill фиксирует эти правила явно, а не надеждой «модель сама догадается».

Telegram-пост и QA-редактура перед публикацией

telegram-post режет лонгрид до хука, пользы и CTA без канцелярита. qa-editor гоняет чек-лист: спорные цифры, повторы H2, клише «в современном мире», утечки внутренних пометок. Только после QA — человек и публикация.

Собираем первый рабочий skill за один проход

Ниже — полный how-to на примере telegram-post. Повторите те же шаги для остальных четырёх ролей.

Шаблон: цель → входы → шаги → примеры → запреты

Создайте .claude/skills/telegram-post/SKILL.md:

---
name: telegram-post
description: Адаптирует готовый лонгрид в пост для Telegram-канала на русском. Использовать, когда нужно сделать анонс статьи, хук, пользу и CTA без воды.
---

# Цель
Сделать один пост 500–900 знаков в тоне канала: польза сразу, без клише.

# Входы
- Текст или ссылка на лонгрид
- CTA (например Telegram-канал или лендинг курса)
- 1 факт/цифра, которую нельзя исказить

# Шаги
1. Выписать одну боль читателя из статьи.
2. Открыть хуком в 1–2 предложениях.
3. Дать 3 пункта пользы.
4. Закрыть CTA одной строкой.
5. Проверить лимит и стоп-слова.

# Пример хорошего результата
[вставьте 1 ваш реальный пост]

# Запреты
- Не выдумывать цифры
- Не обещать «гарантию топа»
- Не публиковать — только черновик для человека

Рядом можете положить references/brand-voice.md с 5 эталонными постами — тело skill останется коротким.

Как проверить, что description реально цепляет задачу

Напишите в чат три формулировки без слэша: «сделай телеграм-пост по этой статье», «адаптируй лонгрид для канала», «нужен анонс в TG». Если skill не подхватывается — допишите эти фразы в description. Затем повторите с явным /telegram-post: поведение должно совпасть.

Дополнительный тест: попросите «напиши SEO-статью» — должен сработать seo-longread, а не telegram-post. Пересекающиеся description — частая причина «не той роли».

Антипаттерны, из-за которых skills «молчат» или вредят

«Лучшие скиллы с GitHub» бесполезны, если у вас сломаны триггеры, раздут контекст или в файле лежат секреты. Ниже — поломки, которые чаще всего ломают контент-команды.

Дубли MCP внутри skill и утечка секретов в инструкции

Не копируйте в skill токены, cookie, строки подключения к Telethon, пароли FTP. Даже «временно». Публичный шаблон конфига — без личных данных. Если skill учит звать MCP, указывайте имя инструмента и формат ответа, а не ключ доступа.

Второй вредный дубль: skill, который пытается «сам быть Wordstat». Чек-лист полей брифа — да. Имитация API внутри markdown — нет.

Помните про безопасность: skill — это инструкции плюс иногда код, почти как установка программы. Берите только из доверенных источников, читайте файлы до включения. Агенты, которые читают чужие сайты, теоретически могут подтянуть вредоносные указания — ещё один аргумент не давать право публикации без человека. Обзор и security-заметки — в документации Anthropic по Agent Skills.

Нет HITL на публикацию: автопост без редактуры

Автоматизация контента ≠ автопилот без тормозов. Цепочка «написал → сразу в канал» рано или поздно выложит ошибку в цифре или жёсткую формулировку. Правило завода: QA-skill → человек → публикация (MCP/кнопка/админ).

Отдельно: не опирайтесь в проде на недокументированные поля frontmatter из разборов исходников Claude Code. Для портативности между Claude, Cursor и Codex хватает канона спецификации.

От одного skill к конвейеру: бриф → статья → пост → QA

Когда пять файлов готовы, вы собираете конвейер без ежедневного переписывания промптов.

Связка skills в цепочку без ежедневного переписывания

Рабочий день выглядит так:

Семантика → wordstat-brief → ТЗ.
ТЗ → seo-longread → черновик статьи.
Черновик → geo-faq → блок FAQ/определений.
Статья → telegram-post → черновик анонса.
Всё вместе → qa-editor → список правок.
Человек утверждает → публикация.

На каждом шаге вы говорите агенту роль или даёте задаче слова из description. Не нужно заново объяснять «как мы пишем H2». Не нужно надеяться, что модель «вспомнит вчерашний чат».

Тот же принцип масштабируется: появился формат Reels-сценария или VK-поста — новый skill, а не новый хаос в избранном мессенджера.

Где встраивается курс «Контент-завод» и нейросети для бизнеса

Файлы SKILL.md — это «станки» линии. Но линия ещё включает агентов, MCP, редакционные роли, автопубликации и контроль качества. Если вы узнали в схеме офисный подход «роль → инструкция → проверка → выкладка», вы уже понимаете логику контент-завода: не один умный чат, а система повторяемых шагов.

Курс и сообщество вокруг контент-завода как раз про сборку такой системы на вайбкодинге, агентах и автоматизации — когда skills перестают быть разовыми экспериментами и становятся рабочей библиотекой команды. Для практики «с нуля до линии» логичный следующий шаг после этого гайда — упаковать ваши пять skills в полный контур производства и дистрибуции, а не коллекционировать промпты в заметках.

FAQ

Чем Claude Skills отличаются от обычного промпта

Промпт живёт в одном диалоге. Skill — в файле с паспортом name/description, подгружается по задаче и может тащить references и скрипты. Промпт Rembrandt на вечер; skill — должностная инструкция на месяц.

Нужен ли Claude Code, чтобы пользоваться skills

Нет. Claude Code — удобный путь с папкой .claude/skills/ и вызовом /имя. Тот же формат Agent Skills поддерживают и другие среды (Cursor, Codex, Gemini CLI и др.). Если Claude Code недоступен из РФ, собирайте библиотеку там, где у вас стабильный доступ, сохраняя канонический SKILL.md.

Сколько skills достаточно на старте контент-завода

Пять: бриф, SEO-лонгрид, GEO/FAQ, Telegram, QA. Шестой добавляйте, когда один и тот же формат повторяется минимум пару раз в неделю и у него есть чёткий критерий «готово».

Можно ли совмещать Skills с MCP и субагентами

Да. Skill задаёт процедуру, MCP даёт доступ к данным и действиям, субагент забирает тяжёлую подзадачу в изолированный контекст. Не заменяйте одно другим: чек-лист не нуждается в MCP, а публикация в WordPress не решается одним markdown-файлом.

Что проверяли по источникам

Спецификация Agent Skills и поля SKILL.md (agentskills.io / документация Anthropic).
Пути и вызов skills в Claude Code.
Отличия Skills / Projects / MCP / subagents (разборы Anthropic).
Рыночный фон GEO: исследование АРИР / SEOnews (74% / доля GEO-практик).
Практические гайды Habr/Hexlet/ProAI — как конкурентный зазор, без копирования устаревших деталей формата.