Skill-Based Architecture — плагин
Метаскилл превращает разрозненные правила в AGENTS.md, CLAUDE.md и Cursor в один проверяемый скилл проекта с маршрутами задач.
- 622 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипт scaffold-downstream.sh с ключом --apply создает папки и файлы в репозитории, хотя по умолчанию показывает только предпросмотр.
- Агент по скиллу переписывает и сливает инструкции проекта, поэтому результат нужно просматривать в git diff.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/skill-based-architectureОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт scaffold-downstream.sh с ключом --apply создает папки и файлы в репозитории, хотя по умолчанию показывает только предпросмотр.
- Агент по скиллу переписывает и сливает инструкции проекта, поэтому результат нужно просматривать в git diff.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл читает репозиторий и собирает из дублирующихся инструкций один проектный скилл в папке skills/<имя>/. Он находит инструкции в AGENTS.md, CLAUDE.md, правилах Cursor и README, отделяет правила от процедур и фактов о коде, выбирает для задачи один рабочий процесс и подгружает знания только тогда, когда без них нельзя принять следующее решение. Форму результата скилл выбирает сам по содержимому репозитория: один SKILL.md, папка с правилами и процедурами или полная структура с routing.yaml. Скрипт scaffold-downstream.sh по умолчанию лишь показывает, что будет создано, сохранено или вызовет конфликт, и пишет файлы только с ключом --apply. Существующие входные файлы остаются нетронутыми до ручного слияния агентом, при сбое созданное откатывается. После миграции работают проверки структуры: ссылки, достижимость файлов, бюджеты строк SKILL.md и покрытие каждой исходной фразы. Тонкие оболочки для Claude Code, Cursor, Codex, Gemini CLI и Windsurf ссылаются на один источник.
Для кого. Командам и одиночным разработчикам, у которых инструкции для агентов разъехались по нескольким файлам и противоречат друг другу, а один SKILL.md перерос читаемый размер.
Подходит, если
- Одни и те же правила скопированы в AGENTS.md, CLAUDE.md и правила Cursor, и они уже расходятся.
- Файл SKILL.md длиннее 150 строк и смешивает правила, процедуры и справку.
- Типовые задачи проекта требуют процедур и проверок готовности, а агент останавливается на промежуточном шаге.
- Дорогие ошибки повторяются, потому что вывод о них записан, но не включается в нужный момент.
- Несколько агентов должны читать одни и те же знания о проекте без трех параллельных наборов правил.
Не подходит, если
- Репозиторий временный, правил меньше трех небольших файлов: автор прямо считает SBA здесь лишним.
- В команде уже работает компактная и надежная система инструкций, переносить ее не планируют.
- Нужен исполняющий рантайм или база задач: SBA остается скиллом и таким средством не служит.
Пример запроса к агенту
Используй skill-based-architecture и наведи порядок в правилах этого проекта.Ограничения
Проверки структуры не доказывают, что смысл каждой старой инструкции сохранен. Покрытие и дословные переносы проверяются скриптами, а пересказанные формулировки опираются на записанную ручную сверку.
Поведение агента проверяют отдельно, и эти прогоны выключены по умолчанию.
В документации репозитория много процедур и терминов: Task Anchor, routing.yaml, Progressive Rigor. На небольшом проекте их освоение занимает больше времени, чем экономит.
Как отключить. Выполните /plugin uninstall для skill-based-architecture или удалите клон. Созданную папку skills/<имя>/ и сохраненные входные файлы можно оставить, они работают без плагина.
Частые вопросы
Как поставить Skill-Based Architecture в Claude Code?
Выполните /plugin marketplace add WoJiSama/skill-based-architecture, затем /plugin install skill-based-architecture@skill-based-architecture. Обновляют маркетплейс командой /plugin marketplace update.
Как использовать скилл в Cursor, Codex или Gemini CLI?
Клонируйте репозиторий рядом с проектом и попросите агента прочитать SKILL.md по явному пути. Особенности входных файлов для каждого агента описаны в references/per-tool-shells.md.
Что скрипт сделает с моими файлами?
Без --apply он ничего не пишет и показывает список CREATE, PRESERVE и CONFLICT. С --apply создает только допущенные папки, существующие AGENTS.md и CLAUDE.md не трогает.
Нужны ли субагенты?
Нет. Они ускоряют работу, но при их отсутствии агент делает то же самое последовательно, и проверки не ослабляются.
Подойдет ли скилл для маленького проекта?
Подойдет в урезанной форме: для малого репозитория он выберет один SKILL.md. Для временного репозитория автор рекомендует его не использовать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСкилл превращает груду скиллов в дерево маршрутизации, чтобы агент загружал только нужные листья
Self-learning
self-learning-skills
Мета-скилл, который после трудной задачи сохраняет найденный рабочий путь в новый скилл или правило для следующих сессий
Настольное приложение и CLI, чтобы ставить, синхронизировать и раскладывать скиллы агентов между Claude Code, Codex, Cursor и другими инструментами
Скилл для создания, проверки и улучшения других скиллов: сначала архитектура, потом тесты, оценка и упаковка
Скилл с 25 командами для разбора и доработки промптов, инструментов и схем агентов в Cursor, Claude Code, Gemini CLI и Codex
CLI компилирует файл SKILL.md в самостоятельного Python-агента с инструментами, поиском по базе знаний и собственным запуском.
Коротко о README
README открывается таблицей «без SBA и с SBA», перечисляет случаи, когда метод нужен и когда лишний, и дает быстрый старт с двумя шагами. Дальше схема прохождения одной задачи, таблица гарантий, совместимость с агентами и вопросы-ответы.