Архитектура скиллов — Полная карта

Фреймворк собран из четырёх источников: блог Anthropic о типах скиллов (capability uplift vs encoded preference), тред Тарика Шихипара — инженера Claude Code в Anthropic — о девяти категориях скиллов и принципах их создания, aviadr1/claude-meta о рефлексивной петле и мета-правилах, и наша модель архитектурных осей.

6 архитектурных осей

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

Промпт-инструкция

Что Claude знает и как думает. Методология, чеклисты, правила, тон. Базовый слой любого скилла.

Чеклист диагностики текста, критерии оценки питча, протокол анализа кейса, фреймворк PESTEL

Оркестрация инструментов

Какие инструменты вызывать, в каком порядке. Сюда входят встроенные инструменты Claude (web search, создание файлов, артефакты) и внешние подключения через MCP-коннекторы (Google Drive, Slack, Notion и др.).

Жёсткий пайплайн: «сначала найди контекст → создай файл → обнови артефакт → запиши в storage»

Persistent State

Данные, которые живут между сессиями. В Claude.ai для этого используется window.storage — встроенное хранилище внутри артефактов, работающее как простая база данных «ключ-значение». В Claude Code — файлы на диске. Превращает скилл из одноразового ответа в приложение с памятью.

Версии текста, профили журналистов, история редакторских решений, снимки метрик

UI-компонент

Интерактивный React-артефакт как интерфейс. Табы, селекторы, визуализации. Скилл проектирует мини-приложение, а не просто текстовый ответ.

Уместен, когда нужна навигация по данным: сравнение версий, фильтрация по параметрам, визуализация трендов, дашборд со статусами

Gotchas & самообучение

Gotchas (от англ. «got you» — «попался») — раздел типичных ошибок, на которых Claude спотыкается. Тарик называет его самым ценным контентом в любом скилле. Эта ось имеет два уровня глубины.

5a — СТАТИЧЕСКИЕ GOTCHAS

Список ошибок, написанный автором скилла вручную. Пополняется при обнаружении провалов. Простой и надёжный, но требует внимания человека.

"NEVER: не переписывай разговорный регистр в академический"
"ALWAYS: проверяй, не потерялся ли авторский голос после правок"

5b — РЕФЛЕКСИВНАЯ ПЕТЛЯ

Встроенный протокол: после ошибки Claude рефлексирует → абстрагирует паттерн → записывает в storage/файл. Мета-правила регулируют формат. Скилл учится автоматически.

Триггер: «Reflect, abstract, generalize, write»
Мета-правила: "NEVER/ALWAYS, lead with why, be concrete, anti-bloat"

Мета-правила — правила о том, как писать правила. Обеспечивают, что при росте gotchas качество не падает: используй абсолютные директивы (NEVER/ALWAYS), начинай с причины (WHY), будь конкретен, минимум примеров, пресекай раздувание. Без мета-правил gotchas деградируют по мере роста — становятся рыхлыми и противоречивыми. С мета-правилами каждая новая запись усиливает предыдущие: эффект накопления.

Композиция скиллов

Скилл может ссылаться на другие скиллы, делегировать им подзадачи, переиспользовать их компоненты. Аналог импорта модулей в программировании. Тарик: скиллы могут «ссылаться на другие по имени, и модель вызовет их, если они установлены».

Скилл оценки партнёрства вызывает скилл анализа журналиста для медиа-контактов; скилл публикации вызывает скилл проверки качества перед отправкой

Почему 6 осей, и почему Ось 5 особенная? Оси 1–4 описывают, что скилл может делать. Ось 5 описывает, как скилл учится на ошибках — на двух уровнях: 5a (человек пишет gotchas) и 5b (Claude сам рефлексирует и записывает). Ось 6 описывает, как скиллы взаимодействуют между собой. Зрелый скилл задействует все шесть осей, включая 5b с мета-правилами.

Обсудить этот гайд в Claude

Откроет новый чат в Claude со ссылкой на этот гайд — поможет разобраться и применить к себе

9 доменных паттернов

Категории Тарика, переведённые из мира кода в универсальный язык. Каждый паттерн — тип задачи, который скилл решает. Домен ортогонален осям: любой домен может быть на любом уровне глубины.

Экспертный справочник

Тарик: Libraries & API Reference

Скилл знает, как правильно работать с конкретным объектом: аудиторией, медиа, стилем, инструментом. Включает подводные камни и best practices.

→ journalist-pitcher, design tokens автора

Проверка качества

Тарик: Product Verification

Скилл проверяет результат по критериям. Чеклисты, тесты, problems panel. Верифицирует до того, как человек увидит результат.

→ essay-editor (7 уровней), pitch-checker

Исследование и мониторинг

Тарик: Data Retrieval & Analysis

Скилл собирает данные из внешних источников, структурирует и анализирует. Может быть разовым или регулярным (трекер).

→ case-research, longitudinal tracker ТГ-канала

Рутинный воркфлоу

Тарик: Ops & Team Automation

Автоматизация повторяющейся процедуры в одну команду. Encoded preference: Claude умеет каждый шаг, скилл задаёт последовательность и формат.

→ weekly-recap, monthly-report, standup

Шаблоны и заготовки

Тарик: Code Scaffolding

Скилл генерирует структуру нового объекта по шаблону. Обеспечивает единообразие и полноту.

→ шаблон питча, шаблон модуля курса, шаблон кейса

Экспертная рецензия

Тарик: Code Quality & Review

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

→ peer-review текстов, рецензия PR-стратегии

Публикация и адаптация

Тарик: CI/CD & Deployment

Скилл берёт готовый контент и адаптирует под разные каналы/форматы. С проверкой требований каждого канала.

→ текст → ТГ + LinkedIn + pitch для медиа

Разбор ситуации

Тарик: Runbooks

На вход — симптом или сигнал. Скилл проводит расследование по протоколу и выдаёт структурированный отчёт.

→ кризисные коммуникации, аномалия в метриках

Административная гигиена

Тарик: Infrastructure Operations

Рутинное обслуживание: чистка, обновление, аудит. Периодические задачи с защитными механизмами.

→ аудит журналистских профилей, чистка контактов

Матрица: Оси × Домены

Где пересечение оси и домена даёт максимальный эффект. Зелёный = уже реализовано или очевидно полезно. Жёлтый = можно добавить, стоит исследовать.

Высокая ценность

Стоит исследовать

Низкий приоритет

	Ось 3: State	Ось 4: UI	Ось 5: Gotchas (5a/5b)	Ось 6: Композиция
D1 Справочник	Профили клиентов, стилевые гайды брендов, API-документация библиотек — хранятся между сессиями, обновляются инкрементально	Карточка профиля с визуализацией: радар стиля автора, карта компетенций сотрудника, дашборд характеристик продукта	"Клиент X не принимает отчёты с диаграммами — только таблицы" / "Библиотека Y сменила API в v3 — старые примеры не работают"	Справочник вызывается из любого скилла, которому нужен контекст: питчер, шаблонизатор, рецензент, адаптатор
D2 Качество	Список проблем по версиям документа, тикетам, итерациям дизайна: resolved / new / persistent. Видна динамика качества	Problems panel с severity (error/warning/info), прогресс-бар исправлений, чеклист перед отправкой/релизом	"Claude пропускает проверку мобильной версии" / "Юридический текст теряет оговорки при упрощении" / 5b: автоматическая рефлексия после каждого отказа	Чекер вызывается перед публикацией (D7), после переписывания (D6), при финализации контракта
D3 Исследование	Снимки рынка, метрик канала, конкурентов, цен — серия snapshot'ов для отслеживания трендов и аномалий	Timeline наблюдений, сравнение двух периодов, графики трендов, автоматическая отметка аномалий	"Данные из источника Y часто запаздывают на 48ч — перепроверять" / "Engagement метрики в соцсетях завышаются ботами"	Трекер поставляет данные в еженедельный отчёт (D4), в разбор ситуации (D8), в справочник (D1)
D4 Воркфлоу	Лог предыдущих запусков: стендапы, дайджесты, отчёты. Diff между неделями — что изменилось, что повторяется	Дашборд: последний vs предыдущий запуск, ключевые расхождения, тренд метрик за последние N запусков	"Еженедельный отчёт теряет фокус при > 5 темах" / "Стендап-бот путает часовые пояса для удалённой команды"	Воркфлоу компонует данные из трекера (D3), справочника (D1), шаблона (D5) — orchestrator других скиллов
D5 Шаблоны	Библиотека шаблонов с рейтингом: какой шаблон питча/brief/proposal давал лучший результат. A/B тестирование формулировок	Низкий приоритет — шаблон линеен по природе	"Шаблон без персонализации = 0% конверсии" / "Шаблон NDA пропускает юрисдикцию — добавить обязательное поле"	Шаблон подставляет данные из справочника (D1) и проходит проверку качества (D2) перед выдачей
D6 Рецензия	История рецензий: какие проблемы автор/команда допускает систематически. Профиль слабых мест, который обновляется	Inline suggestions с accept/reject для каждого замечания. Suggesting mode как в Google Docs	"Claude слишком мягок в рецензии — добавить adversarial режим" / "Код-ревью пропускает edge cases в async — усилить"	Рецензия использует чеклист из проверки качества (D2) и справочник стандартов (D1)
D7 Публикация	Профили каналов: лимиты длины, тона, формата для каждой площадки. Обновляются при смене требований	Preview: как контент будет выглядеть в каждом канале (email, соцсети, лендинг, печать) до отправки	"LinkedIn обрезает лид после 210 символов" / "Email-рассылка с вложением > 5MB блокируется корпоративными фильтрами"	Перед публикацией вызывает проверку качества (D2); берёт шаблон из D5; адаптирует по профилю канала из D1
D8 Разбор	Архив разборов: база инцидентов с тегами, поиск паттернов и прецедентов. «Такое уже было в марте — вот что сработало»	Decision tree: симптом → диагностические вопросы → протокол действий. Визуальный flowchart	"В кризисе первые 2 часа критичны — выдавать предварительный отчёт, не ждать полного анализа" / "Ложные срабатывания мониторинга по выходным"	Разбор запрашивает контекст у исследования (D3), проверяет прецеденты в архиве (D8:state), эскалирует по шаблону (D5)
D9 Гигиена	Лог операций: что обновлено, что архивировано, когда следующий аудит. Автоматические напоминания по расписанию	Низкий приоритет — операция рутинная, UI избыточен	"Не удалять контакт с активностью < 6 мес" / "Не обновлять зависимости без ревью на staging" / "Архивные данные нужны для compliance — не чистить"	Гигиена обновляет данные в справочнике (D1), помечает устаревшие шаблоны (D5), триггерит переобучение трекера (D3)

5 Gotchas

6 Композиция

Сильнейший скилл по оси 4: полноценная дизайн-система (палитра, типографика, маргиналии, hover-взаимодействия) + фирменная трёхколоночная Connection Map (Sources → Categories → Items). Уже на двух осях (1+4), с хорошей оркестрацией (2). Главный апгрейд: Ось 3 — сохранение данных визуализации в storage для обновления без пересоздания (например, R&D-роадмап обновляется ежемесячно). Ось 6 — вызывается из case-research для визуализации кейса, из rhetoric-analyzer для карты метафорического каркаса, из opportunity-map для connection map контактов.

Хотите разобрать свой скилл?

Я собрала мета-скилл skill-architect, который делает архитектурный аудит любого скилла: раскладывает по 6 осям, определяет домен и паттерн, показывает gaps и предлагает конкретные направления апгрейда. Загружаете .skill файл или SKILL.md → получаете визуальный отчёт вроде тех, что выше.

Скачайте скилл и установите в Claude → Settings → Skills.

Три архитектурных паттерна + один мета-паттерн

В ходе нашего анализа мы заметили, что все скиллы различаются по тому, как они работают со временем. Из этого наблюдения выросли три паттерна:

1. Одноразовый анализ — один вход, один выход, без памяти. Так работает большинство скиллов сегодня. Простой и надёжный, но каждый раз с нуля. (Примеры: case-research, 5D, rhetoric-analyzer в текущей версии.)
2. Версионирование — один объект итерируется через версии. Паттерн, перенесённый из Git: branch, diff, merge, accept. Требует persistent state для хранения версий. (Примеры: essay-editor-v2, любой скилл с итеративной работой над документом.)
3. Longitudinal Tracker — один объект наблюдается через серию снимков во времени. Паттерн из аналитики: snapshot, baseline, trend, anomaly. (Примеры: трекинг ТГ-канала, эволюция ораторского навыка, динамика курса.)

Паттерны 2 и 3 требуют оси 3 (persistent state). Без памяти нет ни версий, ни трекинга. Именно ось 3 — водораздел между «промптом» и «приложением».

Мета-паттерн: рефлексивная петля (Ось 5b) — ортогонален трём основным. Любой скилл на любом паттерне может учиться на ошибках: Claude рефлексирует → абстрагирует → записывает gotcha → мета-правила контролируют качество. Ошибки эволюционируют вверх: базовые исчезают, остаются всё более тонкие. Это превращает скилл из инструмента в систему, которая улучшается от использования.