L3-03 — Как сделать свой скилл¶
практик
Сделать свой первый скилл — это десять минут разговора с Claude. Я ждал три месяца, пока решился попробовать. Зря.
В голове у новичка слово «скилл» вызывает ассоциации с программированием. На деле — это просто диалог, в котором Claude задаёт тебе пять-семь вопросов и сам собирает файл с инструкцией. Никакого кода, никаких настроек.
Этот урок — про то, как пройти этот диалог и получить рабочий скилл за один разговор.
Разминка, не подглядывая: какой встроенный скилл делает красивый Word без ручного оформления?
Подход «попроси Claude помочь»¶
Самый простой и работающий способ. Открываешь рабочую папку, запускаешь Claude, говоришь:
«Помоги мне сделать скилл "[название]". Я хочу, чтобы он подключался, когда [описание ситуации]. Сначала задай мне нужные вопросы, чтобы понять задачу. Потом сохрани файл скилла в правильное место.»
Дальше Claude задаёт вопросы по одному. Не все сразу — он спрашивает, ждёт ответа, идёт дальше. Это удобно: не приходится держать в голове все семь пунктов одновременно.
После последнего вопроса он показывает финальный текст скилла и спрашивает: «согласен сохранить?». Соглашаешься — файл появляется в папке .claude/skills/[название]/SKILL.md.
Какие вопросы задаёт Claude¶
Зависит от ситуации, но стандартный набор примерно такой.
Когда нужно подключать? «Опиши коротко: в каких случаях этот скилл должен срабатывать? Например, "когда пользователь даёт текст жалобы гражданина и просит составить ответ".»
Какой результат? «Что должно быть на выходе: текстовый ответ, документ Word, таблица? В какой структуре?»
Какие источники? «На какие файлы или образцы опираться? Регламент, шаблоны, прошлые удачные примеры — где они лежат?»
Какой стиль и тон? «Как должен звучать результат? Деловой, тёплый, формальный, разговорный? Какие слова обязательно использовать, какие — никогда?»
Что игнорировать? «Что не должно попадать в результат? Темы, типы данных, лишние блоки?»
Какие шаги? «В каком порядке делать работу? Сначала разобрать обращение, потом составить позицию, потом текст?»
Что-то особенное? «Есть ли исключения, специальные случаи, на которые надо обратить внимание?»
На каждый вопрос отвечаешь максимум на две-три строки. Не нужно длинно — Claude дальше сам сформулирует.
Анатомия готового файла¶
После разговора у тебя получается файл .claude/skills/название/SKILL.md примерно такой:
---
name: ответ-на-жалобу
description: Используй когда пользователь даёт текст
жалобы или обращения гражданина и просит составить
черновик ответа от имени организации
---
# Ответ на жалобу гражданина
## Структура результата
Деловое письмо с разделами:
1. Реквизиты получателя (адрес, ФИО)
2. Предмет обращения одной фразой
3. Позиция организации по каждому пункту жалобы
4. Ссылки на регламент (файл regulations.pdf)
5. Принимаемые меры или обоснование отказа
6. Контакты для уточнений
## Стиль
Официально-вежливый, без сухости и без сочувствия.
Слова "уважаемый", "сожалеем" — не использовать.
Слова "контрагент", "партнёр" — не использовать (граждане).
## Источники
- regulations.pdf — наш регламент работы с обращениями
- examples/ — папка с прошлыми удачными ответами,
опирайся на их формулировки и стиль
## Чего не делать
- Не извиняться за то, в чём мы не виноваты
- Не использовать юридические термины без необходимости
- Не превышать 1 страницу A4
- Не обещать сроков, не указанных в регламенте
Файл маленький — две-три экранов. Это вся настройка. Дальше скилл живёт сам.
Куда сохранить — рядом или глобально¶
Тот же выбор, что и с CLAUDE.md (L2-11).
Рядом с рабочей папкой. Файл в [папка]/.claude/skills/название/SKILL.md. Скилл подключается только в этой папке. Подходит, если задача специфична для одного проекта.
Глобально для тебя. Файл в C:\Users\ИмяПользователя\.claude\skills\название\SKILL.md. Скилл работает в любой папке. Подходит, если задача универсальна (как «ответ на жалобу» — пригодится в разных папках).
Я делаю так: когда скилл новый и сырой — кладу в одну рабочую папку, проверяю на 2–3 реальных случаях. Если работает — переношу в глобальную. Сразу глобально не делаю: чтобы кривой скилл не лез к задачам, для которых не подходит.
Кейс — собираем скилл «ответ на жалобу гражданин໶
Возвращаемся к задаче из L2-10. Каждый раз я писал длинный запрос про тон, структуру, ссылки. Теперь делаю скилл.
Открыл рабочую папку с регламентом и образцами, запустил Claude:
«Сделай скилл "ответ-на-жалобу". Он должен подключаться, когда я даю текст жалобы или обращения и прошу ответить. Сначала спрашивай меня по одному вопросу, чтобы понять задачу. В конце покажи готовый файл и спроси, согласен ли я.»
Claude задал семь вопросов. Я отвечал коротко:
— «Из чего должен состоять результат?» — Деловое письмо: получатель, предмет, позиция по пунктам, ссылка на регламент, меры или отказ, контакты. — «Какие источники использовать?» — regulations.pdf и папка examples/. — «Какой стиль?» — Официально-вежливый, не сухо и не сочувствующе. Слов «уважаемый», «сожалеем» избегать. — «Что не делать?» — Не извиняться, где не виноваты. Не больше страницы. Не обещать сроков, которых нет в регламенте. — «Какие шаги?» — 1) разобрать пункты обращения. 2) позиция по каждому. 3) текст с ссылками. 4) показать черновик, дождаться правок, переписать финал.
Claude показал готовый файл. Я внёс одну правку (добавил «не использовать слово "проблема" — лучше "ситуация"»). Согласился сохранить. Скилл лёг в .claude/skills/ответ-на-жалобу/SKILL.md.
С этого момента — открываю папку с новой жалобой, говорю: «вот жалоба, составь ответ». Скилл подключается, работает по правилам, выдаёт черновик в моём стиле за минуту.
Тестирование¶
Не доверяй новому скиллу сразу. Прогони его на двух-трёх реальных случаях и посмотри:
— Подключается ли он, когда должен? (Если не подключается — описание-триггер слишком общее или Claude не понимает, что задача подходит.) — Не подключается ли, когда не надо? (Если лезет на чужие задачи — описание слишком широкое, нужно сузить.) — Результат в том стиле, что ты хотел? — Все ли источники подхватываются?
Если что-то не так — открываешь файл скилла, правишь руками. Это обычный текст, никакого волшебства.
Эволюция скилла¶
Как и CLAUDE.md (L2-11), скилл — это живой документ. Дополняешь по ходу работы.
Заметил, что в третий раз исправляешь одну и ту же мелочь? Добавь правило в скилл, чтобы он сразу делал правильно.
Появился новый шаблон ответа на определённый тип обращений? Положи в examples/ и упомяни в скилле.
Изменился регламент? Поправь ссылку в скилле.
У меня скилл «ответ-на-жалобу» за полгода вырос с 25 строк до 60. Каждое добавление родилось из реальной правки, которую я устал делать вручную.
Чего не стоит делать в скилле¶
Не запихивай всё в один. Если задача делится на «ответ на жалобу», «ответ на запрос», «ответ на претензию» — это три разных скилла, у каждого свои правила. Большой скилл «универсальный ответ» работает хуже трёх специализированных.
Не делай скилл из того, что делаешь раз в год. Лучше каждый раз писать запрос с нуля — и не тратить энергию на поддержку файла, который потом забудешь.
Не описывай в скилле очевидное. «Отвечать по-русски», «использовать вежливый тон» — это уже в CLAUDE.md и в общих настройках. Не дублируй.
Не делай скилл без description. Это поле — единственный способ для Claude понять, когда скилл подключать. Если описание расплывчатое или его нет — скилл не сработает или подключится не тогда.
Бояться нечего¶
Скилл — это текстовый файл, не код. Открыл в Word или VS Code — увидел инструкцию словами. Поправил — сохранил — изменения подхватились.
Можно удалить в любой момент. Не нужен — удалил папку со скиллом, и больше его нет.
Скилл не лезет к чужим задачам. Подключается только когда описание совпадает с запросом. На всё остальное — игнорирует.
Если ошибка в скилле — всё видно. В Claude Code есть пометка, какой скилл сейчас активен. Если результат странный — посмотри, может скилл подключился не тот, и поправь описание.
Что попробовать прямо сегодня¶
30 минут — и появится твой первый рабочий скилл.
- Возьми самую повторяемую из трёх задач, которые ты выбрал в L3-01
- Открой рабочую папку с примерами этой задачи в VS Code, запусти Claude
- Попроси: «Сделай скилл "[имя]". Он должен подключаться, когда [описание]. Сначала задай мне вопросы по одному, потом покажи готовый файл и сохрани в правильное место.»
- Ответь на 5–7 вопросов
- Сразу протестируй: возьми 2–3 реальных случая и попроси Claude сделать задачу. Посмотри, что выйдет
- Если что-то не так — открой файл скилла, поправь руками, повтори
Через 30 минут у тебя есть первый собственный помощник, который теперь живёт у тебя в системе и работает каждый раз, когда подходит ситуация.
Что дальше¶
С локальной автоматизацией внутри Claude разобрались. Дальше выходим за пределы папки на компьютере: подключаем Claude к Google-сервисам.
Следующий урок — Google Drive. Чтение и сохранение файлов прямо в твоём облаке, без скачивания. Полезно тем, у кого рабочие документы живут в Drive (а не на локальном диске).
А твой будущий скилл — про что он? Опиши в двух словах: чтобы я понимал, какую боль он будет закрывать.