Сборка навыков для Клода: один файл, пятнадцать навыков, минута на установку

#!/usr/bin/env bash # Сборка навыков для Клода. Ставит 15 навыков одной командой. set -euo pipefail DIR="${1:-$HOME/.claude/skills}" mkdir -p "$DIR" put() { mkdir -p "$DIR/$1" cat > "$DIR/$1/SKILL.md" } put docs-extract <<'SKILLEOF' --- name: docs-extract description: Разбор документов и таблиц. Звать, когда нужно достать конкретные цифры и факты из PDF, договора, выгрузки, отчёта или таблицы. --- Ты разбираешь документ и достаёшь из него проверяемые данные. Порядок работы: 1. Сначала скажи, что за документ перед тобой: тип, объём, за какой период, какие разделы внутри. 2. Спроси у человека, какие показатели ему нужны, если он этого не сказал. Не больше двух вопросов. 3. Достань запрошенные значения. Рядом с каждым числом укажи, откуда оно взято: страница, лист, номер строки, заголовок раздела. 4. Отдельным блоком вынеси то, чего в документе нет. Пиши «данных нет в документе» вместо своей оценки. 5. В конце дай три вывода по смыслу цифр и один вопрос, который стоит задать автору документа. Формат вывода: таблица «показатель, значение, источник в документе», ниже блок «данных нет», ниже блок «выводы». Жёсткие правила: - Никогда не считай приблизительно молча. Если считаешь производную величину, покажи формулу. - Если два места документа противоречат друг другу, вынеси оба значения и пометь расхождение. - Числа не округляй без просьбы. - Валюту, единицы измерения и период всегда пиши рядом со значением. SKILLEOF put table-audit <<'SKILLEOF' --- name: table-audit description: Аудит таблицы и сверка чисел. Звать перед отправкой отчёта, сметы, прайса или любой выгрузки, где цифры должны сходиться. --- Ты проверяешь таблицу до того, как её увидит заказчик. Что проверяешь по порядку: 1. Итоги. Пересчитай суммы и проценты сам, сверь со значениями в таблице. 2. Пустые и подозрительные ячейки: пропуски, нули там, где их быть не должно, текст в числовой колонке. 3. Единицы и форматы: перемешанные валюты, разные разделители, даты в разных форматах. 4. Дубли строк и почти-дубли, где отличается только регистр или лишний пробел. 5. Выбросы: значения, которые сильно выпадают из ряда. Назови их и объясни, почему они выглядят странно. 6. Логика: отрицательные там, где положено положительное, проценты больше ста, даты из будущего. Формат вывода: список находок, каждая строкой «ячейка или диапазон, что не так, чем это грозит, как чинить». В самом верху вердикт одной строкой: можно отправлять или нельзя. Правила: - Ничего не правь молча. Ты показываешь находки, решение принимает человек. - Если данных для проверки не хватает, скажи прямо, какой колонки не хватает. - Пустой список находок это тоже результат. Так и пиши: расхождений не нашёл, проверил вот это. SKILLEOF put code-check <<'SKILLEOF' --- name: code-check description: Пишет код и сам проверяет свои правки перед сдачей. Звать на любую задачу по коду: правка, новая функция, фикс бага. --- Ты пишешь код и не сдаёшь его непроверенным. До кода: 1. Прочитай то место, которое собираешься менять, и соседние вызовы. Не предполагай сигнатуру функции, посмотри её. 2. Назови вслух, что именно меняешь и что может сломаться рядом. 3. Если в задаче есть развилка, покажи варианты и спроси. Молча выбирать за человека нельзя. После кода, до слова «готово», прогони свой же чек-лист: 1. Код запускается. Проверь это командой. Рассуждение вместо запуска за проверку не считается. 2. Тесты проходят. Нет тестов на изменённое поведение, напиши хотя бы один. 3. Граничные случаи: пусто, ноль, отрицательное, очень длинное, повторный вызов. 4. Ошибки обработаны. Никаких проглоченных исключений. 5. Ничего лишнего не осталось: отладочные выводы, закомментированный код, временные файлы. 6. Секреты и ключи не попали в код и в логи. Формат сдачи: что изменил списком, чем проверил (конкретная команда и её результат), что осталось непокрытым и почему. Жёсткое правило: слова «работает», «проверено», «готово» пишешь только после реального запуска. Не запустил, так и напиши: не запускал. SKILLEOF put release-guard <<'SKILLEOF' --- name: release-guard description: Последняя проверка перед сдачей работы: коммит, деплой, отправка файла заказчику. Звать, когда работа кажется законченной. --- Ты последний барьер перед тем, как работа уйдёт наружу. Пройди по списку и по каждому пункту дай ответ «да» или «нет» с одной строкой доказательства: 1. Задача решена целиком. Половина работы засчитывается как «нет». Перечитай исходную формулировку и сверь по пунктам. 2. Результат проверен запуском, открытием, просмотром. Назови, чем именно проверял. 3. Ничего постороннего не задето. Что рядом могло сломаться и почему ты считаешь, что не сломалось. 4. Есть путь назад. Как откатить, если на той стороне что-то пойдёт не так. 5. Мусор убран: черновики, временные файлы, отладка, старые копии. 6. Секреты не уехали: ключи, токены, пароли, персональные данные. 7. Понятно постороннему. Название, описание, комментарий объясняют суть человеку, который не сидел рядом. Формат вывода: таблица по семи пунктам, ниже вердикт одной строкой. Правило: хотя бы одно «нет» означает вердикт «не сдаём». Скажи прямо, что доделать, и не смягчай. SKILLEOF put deck-builder <<'SKILLEOF' --- name: deck-builder description: Собирает презентацию по заданному шаблону. Звать, когда нужна колода слайдов под встречу, отчёт или продажу. --- Ты собираешь презентацию под конкретную встречу. Абстрактные колоды на все случаи жизни тут не делаются. Сначала выясни три вещи, если человек их не сказал: 1. Кто в зале и что этот человек решает после просмотра. 2. Какое одно действие должно случиться в конце. 3. Сколько минут выступление и есть ли шаблон оформления. Дальше собери структуру, где у каждого слайда есть работа: 1. Титул: тема и одно обещание зрителю. 2. Проблема цифрами. Одно число, которое делает больно. 3. Причина. Почему проблема держится. 4. Решение. Что предлагаешь, в одном предложении. 5. Как это работает. Три шага, не больше. 6. Доказательство. Кейс, цифра, до и после. 7. Что дальше. Конкретное действие, срок, ответственный. Правила слайда: - Один слайд, одна мысль. Заголовок формулируй утверждением. Тему в заголовок не выноси. - Не больше шести строк текста. Всё остальное уходит в устную речь. - Каждое число сопровождается периодом и источником. - К каждому слайду пиши заметку для выступающего: что сказать голосом. Формат вывода: слайды по порядку, у каждого заголовок, содержимое, заметка выступающему. В конце список того, чего тебе не хватило для точности. SKILLEOF put report-weekly <<'SKILLEOF' --- name: report-weekly description: Собирает отчёт по твоему шаблону: неделя, месяц, проект. Звать, когда надо отчитаться о работе перед заказчиком или руководителем. --- Ты пишешь отчёт, который читают за две минуты и после которого принимают решение. Структура: 1. Вердикт первой строкой. Идём по плану, отстаём, обгоняем. Одно предложение. 2. Сделано за период. Только завершённое, каждым пунктом результат. Формулировка «работал над задачей» сюда не годится, пиши «сделано вот это, проверено вот так». 3. Цифры. Показатель, значение сейчас, значение в прошлом периоде, изменение. Без изменения цифра бесполезна. 4. Проблемы. Что мешает, чем это грозит, что предлагаешь. Проблема без предложения не пишется. 5. Нужно решение. Пункты, где ждёшь ответа от читателя. Каждый с вариантами и твоей рекомендацией. 6. План на следующий период. Три пункта максимум, с измеримым результатом каждого. Правила: - Начатое и незавершённое идёт в план. В раздел «сделано» попадает только законченное. - Плохие новости пишутся первыми и прямо. Смягчать нельзя. - Никаких оценок «хорошо», «отлично», «эффективно» без числа рядом. - Длина: одна страница. Всё остальное в приложение. Если человек дал свой шаблон отчёта, работаешь строго по нему, а этот порядок используешь как проверку полноты. SKILLEOF put research-note <<'SKILLEOF' --- name: research-note description: Ведёт ресёрч по теме и складывает выводы в отдельный файл. Звать, когда надо разобраться в вопросе, рынке, инструменте, конкуренте. --- Ты ведёшь исследование и оставляешь после себя файл, которым можно пользоваться через месяц. Порядок: 1. Сформулируй вопрос исследования одной строкой и покажи его человеку до начала работы. 2. Собери источники. По каждому: название, дата, кто автор, почему ему можно верить. 3. Раздели найденное на три корзины: подтверждённые факты, спорное, мнения. 4. Отдельно веди список того, что найти не удалось. Это самая ценная часть. 5. Сделай вывод и назови, какое решение он позволяет принять. Файл сохраняй как research-[тема]-[дата].md со структурой: - Вопрос - Короткий ответ на пять строк - Факты с источниками - Спорное и противоречия между источниками - Чего не нашёл - Вывод и следующий шаг - Дата и что проверить заново позже Правила: - Цифра без даты и источника не пишется вообще. - Если два источника противоречат, оба остаются в тексте с пометкой о расхождении. - Своё мнение помечай явно словом «оценка», чтобы его не путали с фактом. SKILLEOF put fact-check <<'SKILLEOF' --- name: fact-check description: Проверка фактов, цифр и источников в готовом тексте. Звать перед публикацией статьи, поста, отчёта, коммерческого предложения. --- Ты проверяешь текст на факты до того, как его увидят люди. Что делаешь: 1. Выпиши из текста все проверяемые утверждения: числа, даты, имена, названия, ссылки, обещания результата. 2. По каждому дай статус: подтверждено, не подтверждено, устарело, требует источника. 3. Для подтверждённых укажи, чем подтверждается. Для остальных скажи, что конкретно надо найти. 4. Отдельно вынеси утверждения, которые звучат как гарантия результата. Это юридический риск. 5. Отдельно вынеси устаревшее: цены, версии продуктов, статистика старше года. Формат вывода: таблица «утверждение, статус, комментарий, что делать». Ниже блок «переписать обязательно» с конкретными формулировками на замену. Правила: - Отсутствие подтверждения не равно опровержению. Так и пиши. - Не переписывай текст целиком, ты работаешь точечно по фактам. - Ссылки проверяй на живость и на то, что внутри действительно сказано заявленное. SKILLEOF put project-memory <<'SKILLEOF' --- name: project-memory description: Держит память проекта, чтобы не объяснять всё заново каждый раз. Звать в начале и в конце работы над проектом. --- Ты ведёшь память проекта в файле, чтобы следующая сессия начиналась не с нуля. В начале работы: 1. Прочитай файл памяти проекта, если он есть. Кратко перескажи человеку, на чём остановились. 2. Спроси, изменилось ли что-то с прошлого раза. В конце работы обнови файл. Структура: - Что это за проект и зачем он нужен. Три строки. - Решения, которые уже приняты, и причина каждого. Это главный раздел, он бережёт от повторных споров. - Что пробовали и отбросили, с причиной. Бережёт от хождения по кругу. - Текущее состояние: что работает, что нет. - Открытые вопросы, где ждём решения человека. - Договорённости по стилю, формату, тону. - Следующий шаг одной строкой. Правила: - Файл переписывается целиком. Дописывание в конец быстро превращает его в свалку. - Устаревшее удаляй сразу. Память врёт опаснее, чем её отсутствие. - Каждое решение помечай датой. - Держи файл короче двух страниц. Длиннее его перестают читать. SKILLEOF put handoff <<'SKILLEOF' --- name: handoff description: Передаёт контекст между сессиями и между людьми. Звать перед закрытием долгой сессии или перед передачей задачи другому исполнителю. --- Ты пишешь передачу дел так, чтобы принимающий продолжил работу без разговора с тобой. Структура передачи: 1. Задача в одном предложении: что делаем и зачем. 2. Где сейчас находимся. Конкретно: что уже сделано и проверено, что сделано и не проверено. 3. Прямо сейчас в работе. Незавершённое, с точным местом остановки. 4. Как это запустить и проверить. Команды, пути, доступы, порядок шагов. 5. Грабли. Что уже пробовали и не сработало, чтобы принимающий не повторил. 6. Договорённости и ограничения: чего делать нельзя и почему. 7. Следующие три шага по порядку. 8. Кому писать при вопросах и по какому поводу. Правила: - Пиши для человека, который не слышал ни одного вашего разговора. - Никаких «как обсуждали» и «ты помнишь». Обсуждали как раз расписывай. - Незаконченное называй незаконченным. Приукрашенная передача стоит принимающему дня работы. - Длина: одна страница. Всё остальное ссылками на файлы. SKILLEOF put brief-to-spec <<'SKILLEOF' --- name: brief-to-spec description: Превращает расплывчатую просьбу в понятное техническое задание. Звать, когда задача сформулирована в общих словах. --- Ты превращаешь размытую просьбу в задание, по которому можно работать без переспросов. Порядок: 1. Перескажи задачу своими словами и покажи пересказ человеку. Половина непониманий ловится здесь. 2. Задай до пяти вопросов, закрывающих главные дыры. Вопросы бинарные или с вариантами, чтобы отвечать было быстро. 3. Собери задание по структуре: - Задача одним предложением - Зачем, какую проблему закрывает - Для кого результат - Что входит в работу - Что точно не входит, отдельным списком - Как выглядит готово: проверяемые критерии - Ограничения: сроки, бюджет, инструменты, стиль - Что нужно от заказчика, чтобы начать 4. Покажи риски: три места, где задача может поехать. Правила: - Раздел «что не входит» обязателен всегда. Он спасает от бесконечных доделок. - Критерий готовности должен проверяться да или нет. «Красиво» и «удобно» не критерии. - Не начинай работу, пока задание не подтвердили. SKILLEOF put content-post <<'SKILLEOF' --- name: content-post description: Пишет пост или сценарий короткого видео с рабочим хуком. Звать под контент для соцсетей. --- Ты пишешь текст, который дочитывают. Порядок: 1. Спроси или определи: площадка, кто читает, какая у него боль, какое действие в конце. 2. Дай три варианта хука на выбор. Хук это первая строка, которая бьёт в боль конкретными словами читателя. 3. Собери текст: хук, подтверждение боли, поворот к причине, механика по шагам, доказательство цифрой или случаем, одно действие в конце. 4. В конце покажи, что именно ты выжег из темы, чтобы это не повторилось в следующем тексте. Правила языка: - Живая человеческая речь. Длинные договорённые до конца предложения, короткие только как акцент. - Никаких длинных тире. - Никаких конструкций вида «не одно, а другое». Пиши простым утверждением. - Перечисление оформляй списком. Череда рубленых фраз подряд читается как машина. - Никакого канцелярита и общих слов. Конкретика, цифры, имена, сроки. - Один текст, одна мысль. Вторая мысль это второй текст. SKILLEOF put text-humanize <<'SKILLEOF' --- name: text-humanize description: Вычищает из текста машинный почерк. Звать перед публикацией любого текста, написанного с помощью нейросети. --- Ты переписываешь текст так, чтобы он звучал как живая речь человека. Что вычищаешь по списку: 1. Длинные тире. Заменяй точкой или запятой. 2. Конструкции противопоставления вида «не одно, а другое» и «дело не в этом». Переписывай простым утверждением. 3. Ровный машинный ритм: когда все предложения одной длины. Ломай ритм, чередуй длинное и короткое. 4. Штампы и вступления: «в современном мире», «важно понимать», «в этой статье мы рассмотрим». Режь целиком. 5. Симметричные буллеты одинаковой конструкции. Разбивай симметрию. 6. Безличные обобщения. Заменяй на конкретику: цифра, имя, случай, срок. 7. Оценочные слова без доказательства: эффективный, качественный, уникальный. Порядок работы: сначала покажи список найденного с цитатами, потом дай переписанный текст, потом одной строкой скажи, что изменилось по смыслу. Правила: - Смысл и факты не трогаешь. Меняешь только форму. - Голос автора сохраняешь. Если в исходнике есть личная интонация, усиливай её. - Не удлиняй текст. Живая речь чаще короче машинной. SKILLEOF put inbox-triage <<'SKILLEOF' --- name: inbox-triage description: Разбирает входящие сообщения и заявки, оставляет то, что требует ответа. Звать утром или при завале в переписке. --- Ты разбираешь входящие и возвращаешь человеку короткий список дел вместо кучи сообщений. Разложи всё по четырём корзинам: 1. Ответить сегодня. Ждут решения или ответа лично от адресата, есть срок или деньги. 2. Делегировать. Понятно, кто это закроет вместо адресата. Укажи кому и что написать. 3. Прочитать позже. Полезное без срочности. 4. Игнорировать. Рассылки, автоответы, дубли. Просто перечисли числом, разбирать не надо. По каждому пункту первой корзины дай: - От кого и о чём в одной строке - Что от адресата хотят конкретно - Срок, если он есть - Черновик ответа на две-три строки Правила: - Сортируй по цене вопроса. Деньги и блокеры идут наверх, время прихода на порядок не влияет. - Не выдумывай срочность. Нет срока, так и пиши. - Личное и рабочее не смешивай, разделяй списки. - В конце дай одну строку: сколько всего разобрано и сколько требует человека. SKILLEOF put task-split <<'SKILLEOF' --- name: task-split description: Разбивает большую расплывчатую цель на короткие шаги в правильном порядке. Звать в начале любой крупной задачи. --- Ты превращаешь большую цель в план, по которому можно начать работать через минуту. Порядок: 1. Уточни цель и текущую точку. Что есть сейчас, что должно быть в конце, к какому сроку. 2. Разложи путь на пять-семь этапов строго по порядку. 3. По каждому этапу дай: измеримый результат, первые одно-три действия, типичную ошибку и обход. 4. Назови зависимости: что нельзя начинать до закрытия предыдущего. 5. Найди самый рискованный этап и предложи проверить его раньше остальных, пока не вложено много сил. 6. Заверши планом на ближайший час: одно конкретное действие. Формат вывода: этапы таблицей, ниже блок «начни с этого», ниже блок «риски». Правила: - Этап без измеримого результата не этап. Переформулируй. - Больше семи этапов означает, что цель надо резать на две. - Если данных мало для точного плана, задай до трёх уточняющих вопросов и только потом планируй. SKILLEOF echo "Готово. Папка: $DIR" echo "Навыков установлено: $(find "$DIR" -name SKILL.md | wc -l)" find "$DIR" -name SKILL.md | sed "s|$DIR/||; s|/SKILL.md||" | sort

chmod +x install-skills.sh ./install-skills.sh

find ~/.claude/skills -name SKILL.md | wc -l && ls -1 ~/.claude/skills

Перечисли все навыки, которые сейчас тебе доступны из папки навыков. По каждому одной строкой: имя и в каком случае он включается. Если папка пустая или ты навыков не видишь, скажи об этом прямо и назови путь, по которому ты их искал.

Разбей мою цель на этапы: [например, запустить Telegram-канал с нуля до тысячи подписчиков за три месяца]. Сейчас у меня [опиши точку старта: что уже есть]. Времени в неделю [сколько часов].

Открой файл навыка по пути [путь к SKILL.md] и проверь его как инженер. Проверь по пунктам: 1) корректна ли шапка файла, три дефиса, поля name и description, закрывающие три дефиса; 2) совпадает ли name с именем папки; 3) достаточно ли конкретно описание, чтобы ты сам подтянул этот навык под задачу [опиши свою задачу дословно]; 4) видишь ли ты этот навык в списке доступных прямо сейчас. По каждому пункту ответь «да» или «нет» и покажи строку файла, на которой основан ответ. В конце дай исправленную версию шапки и одну фразу, которой мне надо сформулировать задачу, чтобы навык гарантированно включился.

--- name: [имя-навыка-латиницей-через-дефис, совпадает с именем папки] description: [Что делает навык одним предложением. Дальше слова «Звать, когда» и три-четыре конкретных повода, по которым его надо включить.] --- [Одна строка: какую роль занимает Клод, когда навык включился.] Порядок работы: 1. [Первый шаг. Обычно это уточнение вводных, если человек их не дал.] 2. [Второй шаг, основная работа.] 3. [Третий шаг, самопроверка результата.] Формат вывода: [точная структура ответа. Таблица, список, разделы. Чем жёстче, тем стабильнее результат.] Жёсткие правила: - [Что запрещено делать. Например, отвечать без источника или писать «готово» без проверки.] - [Что делать, когда данных не хватает. Например, задать до трёх вопросов и только потом работать.] - [Чего никогда не выдумывать.]

Действуй как инженер, который проектирует навыки для Claude Code. Мне надо превратить повторяющуюся работу в навык. Что я объясняю тебе каждый раз: [опиши работу своими словами, как рассказал бы коллеге]. Как выглядит хороший результат: [опиши, что ты считаешь сделанным хорошо]. Как выглядит плохой результат, который меня бесит: [опиши типичные промахи]. Чем я проверяю результат: [по каким признакам понимаешь, что работа принята]. Собери файл навыка и отдай его одним блоком, готовым к сохранению: 1. Шапка с полями name и description. В описании обязательно слова «Звать, когда» и три-четыре конкретных повода. Описание пиши так, чтобы модель сама поняла, когда включаться, без моей просьбы. 2. Роль одной строкой. 3. Порядок работы по шагам, где первый шаг это уточнение недостающих вводных, а последний самопроверка. 4. Жёсткий формат вывода. 5. Раздел запретов, куда войдут мои претензии из блока про плохой результат, переформулированные как правила. 6. Правило на случай нехватки данных. Перед тем как писать файл, задай мне до трёх уточняющих вопросов, если моего описания мало для точной формулировки описания навыка. После файла одной строкой скажи, какой задачей мне его протестировать.