Алексей | AI PROKA4

🔥 Скилл - это не только SKILL.md SKILL.md - это вход. Но рядом в папке можно положить ещё кучу всего, и вот тут скиллы становятся по-настоящему мощными. Три типа соседей: 🟢 references/ - справочники, гайдлайны, примеры. Длинные доки, которые не нужны каждую секунду 🟢 scripts/ - реальные скрипты (Python, bash), которые скилл запускает 🟢 assets/ - шаблоны и файлы-болванки Вся соль в том, КОГДА это грузится. Помните такую вещь, как прогрессивная загрузка (загрузка слоями)? Вот её третий слой: содержимое этих папок попадает в контекст только в момент, когда скилл до него дотянулся. Лежат двадцать референсов - пока не понадобились, контекст они не занимают. Зачем scripts/ отдельно от инструкций. Инструкция - это «модель читает и делает по-своему». Скрипт - это «запусти ровно вот это». Если шаг должен отрабатывать одинаково каждый раз (распарсить лог, посчитать, переформатировать), не проси модель импровизировать - дай ей скрипт. Пример. Скилл проверки покрытия:

coverage-check/
  SKILL.md            # когда звать + что делать
  scripts/
    run.sh            # прогоняет тесты с покрытием, парсит результат
  references/
    thresholds.md     # какие пороги считаем нормой

В SKILL.md строчка вида «запусти scripts/run.sh, сравни с references/thresholds.md». Модель не считает покрытие в уме - она дёргает скрипт и читает цифры. Меньше галлюцинаций, стабильный результат. Правило: всё, что должно быть детерминированным - в скрипт. Всё, что справочное и длинное - в references. SKILL.md держи коротким.

Лайфак: перед тем как очищать сессию или компактить, спросите Claude «Что из текущей сессии можно трансформировать в Skill?»

#skills

🫠UPD. Вскрылись детали - и это уже просто абсурд. Оказалось, Anthropic заранее предупреждала государство о релизе и получила одобрение на запуск. А через день ей дали 90 минут, чтобы всё свернуть. Полтора часа на то, чтобы выключить флагман. И теперь понятно, кто это завёл - Amazon. Их CEO с компанией обзванивали чиновников и пугали возможностями модели: мол, Fable находит реальные уязвимости в чужом софте. И вот тут самое смешное: это ровно то, о чём я писал. Дело не в «узком jailbreak», дело в том, что штука реально мощная. Я её потрогать успел - интуиция не подвела. А эксперт, которому показали тот самый отчёт, назвал реакцию власти несоразмерной: модель находила дыры, отвечая на обычные вопросы защитника. Ровно то, для чего её и делали. Но пугает не это. Пугает формулировка из инсайдов - «де-факто лицензионный режим». То есть выключили не одну модель. Показали, что так теперь можно с любым, чей продукт окажется слишком хорош. Вот от этого и не по себе. Очень хочется ошибаться.

⚡️Вот и приехали... Правительство США только что заставило Anthropic выключить две свои топовые модели - Fable 5 и Mythos 5🙂 Не оштрафовало, не пригрозило, а буквально: вырубите доступ. Экспортная директива, ссылка на нацбезопасность, запрет для любого иностранца - и внутри Штатов, и снаружи. Даже для своих же сотрудников без американского паспорта. И так как разделить «иностранцев» и «всех остальных» на лету нельзя - модели просто выключили для всех. Я сижу с этим пол дня и ловлю странное чувство. Мне теперь по закону нельзя притронуться к инструменту, который вышел буквально на этой неделе. И самое жесткое - повод. Узкий jailbreak, который, по словам самой Anthropic, спокойно воспроизводится и на других публичных моделях. То есть отрубить флагман на сотни миллионов людей можно из-за дырки, которая есть у всех. Если так начнут делать со всей индустрией - выкатка новых моделей встанет в принципе. Я обычно про это пишу с позиции «строю, экспериментирую, кайфую». А сегодня впервые поймал себя на том, что мне немного не по себе. Вот, собственно, и показатель - когда даже мне, который во всём этом варится каждый день, становится чуть-чуть страшно. Честно, я не верю, что причина в jailbreak, так как я успел прикоснуться к Fable 5 и это жесть... Думаю причина в этом. Посмотрим, откатят ли. Anthropic говорит, что это недоразумение и что они борются за восстановление. Очень надеюсь, что да.

🔥 Как написать свой скилл за 5 минут В прошлый раз разобрали, что такое скиллы. Теперь делаем свой - возни меньше, чем кажется.

Скилл - это папка с одним файлом SKILL.md. Файл из двух частей: YAML-шапка и тело.

Шапка (между ---) говорит Claude, КОГДА звать скилл. Тело - что делать, когда позвал.

---
name: commit-msg
description: Пишет аккуратное сообщение коммита по staged-диффу.
  Звать, когда пользователь просит закоммитить или
  сформулировать коммит.
---

# Что делать:

1. Прочитай git diff --staged
2. Заголовок до 50 символов в стиле Conventional Commits
3. Тело: что изменилось и зачем, без воды
4. Покажи сообщение, дождись подтверждения, потом коммить

Куда положить: • ~/.claude/skills/commit-msg/SKILL.md - личный, во всех проектах • .claude/skills/commit-msg/SKILL.md - проектный, в гит на всю команду Имя папки = имя скилла. Перезапускать ничего не надо: Claude подхватит его в следующей сессии. И главное - описание. По нему модель решает, звать скилл или нет. Пиши не «про коммиты», а «когда пользователь просит закоммитить». Чем конкретнее триггер, тем надёжнее срабатывает. Размытое описание - и скилл лежит мёртвым грузом. С чего начать: возьми одно действие, которое повторяешь каждый день, и опиши его шаги. Один скилл - одна задача. Дальше распробуешь. #skills

⚡️Мой YouTube канал тоже оживет в скором времени) Контент соответственно будет про AI, разработку, кастомные решения и прочее!

🔥 Скиллы в Claude Code: научил один раз, работает всегда Прошлый пост был про CLAUDE.md, который грузится в контекст в начале каждой сессии. Скиллы устроены иначе: лежат и ждут, пока понадобятся.

Скилл - это папка с файлом SKILL.md внутри. Там ты пишешь, как делать конкретную задачу: шаги, правила, что на входе, что на выходе. Рядом можно положить скрипты и шаблоны, и скилл их дёрнет, когда дойдёт до дела.

Зачем они, если уже есть CLAUDE.md? Затем, что CLAUDE.md сидит в контексте всю сессию и ест токены, даже когда ты пишешь код, к которому он вообще не относится. А скиллов у тебя может накопиться полсотни. Запихни их все разом - и под саму задачу места не останется. Поэтому скиллы грузятся слоями. На старте Claude читает только имя и описание каждого, одна строчка, копейки по токенам. Совпало описание с задачей - подтянул тело SKILL.md с инструкциями. Внутри лежат скрипты или примеры - подгрузятся ещё позже, когда до них дойдёт дело, и лишнего в контексте не висит. Из-за этого описание решает почти всё. По нему Claude понимает, звать скилл или нет. Напишешь размыто - скилл будет молча простаивать, а ты не поймёшь почему. Где они лежат. Личные кладёшь в ~/.claude/skills/<имя>/SKILL.md, они видны во всех проектах. Проектные - в .claude/skills/<имя>/SKILL.md проекта, эти коммитятся в гит и едут с кодом на всю команду. Ещё есть плагины со своим неймспейсом plugin:skill, чтобы имена не сталкивались. Имя папки заодно становится слэш-командой: зови руками через / или дай Claude подхватить самому. И чтобы не было каши: скилл говорит агенту, как себя вести. MCP даёт ему новые руки - сходить в гитхаб, дёрнуть базу, написать в слак. Вещи разные, в связке дополняют друг друга. Живой пример - скилл, который разбирает флаки-тест. Кладём в ~/.claude/skills/flaky-triage/SKILL.md:

---
name: flaky-triage
description: Разбирает нестабильно падающий тест. Звать, когда
  тест флакает или просят понять причину рандомных падений.
---

# Что делать:

1. Прогони тест 5 раз подряд, собери статистику падений
2. Проверь типовые причины: гонки, неявные ожидания,
   общий стейт между тестами, зависимость от порядка
3. Не лечи через time.sleep, ставь явные ожидания
4. Дай минимальную правку и объясни, почему тест флакал

Теперь я кидаю агенту упавший тест, и он идёт по этим шагам сам, а не гадает каждый раз заново. И вот это и есть самое важное в скиллах. Не выдумывай умные навыки ради галочки. Лови моменты, когда делаешь одно и то же по второму-третьему разу: объясняешь агенту один и тот же разбор, копипастишь один и тот же кусок промпта. Каждый такой повтор - готовый скилл. Записал шаги один раз, дальше к этому не возвращаешься. P.S. У меня в claude-code-python-stack собрано 20 скиллов под Python и QA, от генерации тестов до разбора CI-логов. #skills

🧠 CLAUDE.md - самый важный файл в проекте, на который многие забивают Вы работаете с Claude Code и в каждой новой сессии заново объясняете ему, какой у вас стек, как запускать тесты и куда не лезть потому что он забыл?) Для этого как раз и существует CLAUDE.md На деле, это просто markdown-файл в корне проекта. Claude Code сам подтягивает его в контекст в начале каждой сессии - без команд, без настройки. Открыл проект и он уже знает правила. Что туда кладут: стек с версиями (он не угадает, что у тебя Next.js 15, а не 14), команды сборки и тестов, код-стайл, что трогать нельзя. Всё, что агент не вытащит, просто читая код. ➡️И вот главное, что многие не понимают. CLAUDE.md - это не промпт «будь умнее, пожалуйста». Это документ-ограничитель. Он перехватывает дефолтное поведение агента до того, как оно сработало. Как чеклист на ревью, ты не держишь все правила в голове, а сверяешься со списком. Самое главное, не раздувайте. Всё, что лежит в файле, ест токены каждую сессию. Многословие = меньше места под саму задачу. Где живёт? Ну тут прям интересно, ибо он не один: 🟢./CLAUDE.md - командный, в гите 🟢CLAUDE.local.md - твои личные хотелки, в .gitignore 🟢~/.claude/CLAUDE.md - глобальный, на все проекты сразу 🟢не знаешь, с чего начать - запусти /init, он соберёт стартовый по твоему проекту. Дальше читаешь, выкидываешь очевидное, дописываешь как реально работаешь. 📎 В приложении - пример Прикрепил уже нащумевший «карпатовский» CLAUDE.md, 100K+ звёзд на гитхабе. Сразу честно: написал его не Карпатый, а Forrest Chang. Он взял вирусный тред Карпатого (январь 2026) про то, как LLM факапят в коде, и упаковал в четыре правила: 🟢Не делай молчаливых допущений - не уверен, спроси. Один вопрос в начале экономит пять кругов правок. 🟢Не переусложняй - решается в 20 строк, не пиши 200. 🟢Хирургическая точность - трогай только то, о чём попросили. Без drive-by рефакторингов. 🟢Цель важнее инструкций - сначала тест, потом код, который его проходит. Полезно держать в голове в любом случае, даже если сам файл не ставите!

⚡️MCP - Model Context Protocol. Все говорят, мало кто понимает. Объясняю. Представь: ты QA-лид. Твои инструменты: → Linear/Jira (тикеты) → GitLab (код, PR) → Slack (коммуникация) → Allure (отчёты) → БД (тестовые данные) Без MCP: ты - человек-роутер. Открыл Linear → прочитал тикет → переключился в IDE → написал тест → переключился в GitLab → создал MR → переключился в Slack → написал "готово". С MCP: AI - роутер. Ты говоришь: "Посмотри тикет QA-127, напиши тесты, создай MR в ветку feature/auth" AI через MCP: идёт в Linear → читает тикет → понимает требования → пишет тест → создаёт MR → отписывается в Slack. ➡️КАК ЭТО РАБОТАЕТ ТЕХНИЧЕСКИ: Ключевое: MCP - это протокол. Как HTTP для веба, только для AI ↔ Инструменты. Каждый инструмент = MCP-сервер. AI (Claude Code) = MCP-клиент. Между ними - стандартный протокол. Это значит: 1. Один раз настроил - работает 2. Новые инструменты подключаются как плагины 3. AI комбинирует инструменты сам (прочитал тикет + посмотрел код + написал тест) Настроить можно за 15 минут.