version: "1.0.1" name: skill-creator-ext description: MUST load together with skill-creator in GBIG context. Adds категории навыков фреймворка (bsl-practices, tool-usage, spec-writing), BSL-паттерны контента и интеграцию 1c-ai-agent-cli.

Skill Creator — 1C BSL Framework Extension

Базовый навык: skill-creator (Anthropic).

Сначала прочитай базовый навык — он содержит общие принципы создания skills.

Этот файл добавляет только 1С-специфику фреймворка.

1. Когда создавать новый навык

НЕ создавать навык если:

• Информация уже есть в существующем навыке — дополнить его
• Это одноразовая инструкция — сделать prompt, не skill
• Это правило/политика (MUST/SHOULD) — создать rule, не skill

2. Категории навыков фреймворка

Расширения (-ext) — конвенция

1. Базовый навык устанавливается через npx skills add (обновляемый)
2. Расширение — <base-name>-ext/SKILL.md в framework/skills/
3. Расширение только дополняет, не дублирует содержимое базового навыка
4. В расширении: > Сначала прочитай базовый навык: <имя>

3. Процесс создания навыка

1. Анализ: определить категорию, проверить на дублирование, определить зависимости
2. Проектирование: имя kebab-case.md, целевой лимит 300 строк (max 500)
3. Написание — обязательные секции:

• YAML frontmatter
• Заголовок + 1-3 предложения назначения
• Когда применять — таблица триггер → действие
• Сценарии — конкретные примеры
• Примеры кода — правильно + неправильно с объяснением ПОЧЕМУ

1. Интеграция: файл в framework/skills/, обновить skills в агентах, python tools/install.py --list

Указатель на уроки (конвенция). Если у навыка есть (или появится) references/learned-patterns.md — в теле SKILL.md ОБЯЗАТЕЛЬНА строка-указатель, иначе агент не увидит накопленные уроки при работе с навыком:

**Накопленные уроки:** см. references/learned-patterns.md (confirmed — как правила, candidate — как подсказки).

Это парная сторона к правилу skill-learning-policy: правило задаёт триггер чтения, здесь — конвенция оформления ссылки в навыке-владельце.

4. Tool-usage навыки — замена tool-registry

Tool-usage навыки — единственное место где описаны MCP-инструменты в фреймворке.

Структура tool-usage навыка

# [Название] — как использовать MCP-инструменты для [задачи]
 
## Когда применять
 
| Триггер | Действие |
|---------|----------|
| Пользователь просит проверить синтаксис | Вызвать `bsl.checkSyntax(uri)` |
| Агент написал/изменил .bsl код | Автоматически проверить синтаксис |
 
## MCP-инструменты
 
| Инструмент | Назначение | Workarounds |
|------------|------------|-------------|
| `bsl.checkSyntax` | Проверка синтаксиса | Если URI не найден — проверить encoding |
 
## Сценарии
[Конкретные цепочки вызовов]

Принципы

1. Не дублируй описание MCP-инструмента — оно приходит из MCP (tools/list)
2. Фокус на КОГДА и ПОЧЕМУ, не на параметрах
3. Workarounds и подводные камни — главная ценность
4. Конкретные сценарии — цепочки вызовов для типичных задач

5. Форматы навыков

6. Паттерны контента

Триггер → Действие (tool-usage): таблица | Триггер | Действие |

Правильно / Неправильно (bsl-practices): два блока кода + объяснение ПОЧЕМУ (последствие нарушения)

Воркфлоу с чек-листом (методологии): - [ ] Шаг N: ...

Условный воркфлоу (ветвления): Определи тип → ветка A / ветка B

7. Проектные навыки (project-specific)

Размещение: .cursor/skills/ или .claude/skills/ в корне проекта. Формат Anthropic SKILL.md.

Включать: архитектура конфигурации, локальные conventions, бизнес-правила, критичные модули, интеграции.

НЕ включать: общие стандарты BSL (во framework-навыках), секреты, быстро устаревающую информацию.

8. BSL-специфика

Ограничения платформы

• BSL не поддерживает наследование — только общие модули
• Нет package manager — зависимости через конфигурацию
• Код разделён по контекстам (сервер/клиент/внешнее соединение)
• Метаданные — декларативные, код — императивный

9. Чек-лист нового навыка

• [ ] YAML frontmatter, имя kebab-case (латиница)
• [ ] Объясняет ПОЧЕМУ, примеры правильно/неправильно
• [ ] Таблица "Когда применять" (триггер → действие)
• [ ] Нет дублирования с существующими навыками
• [ ] Объём ≤ 300 строк (max 500)
• [ ] Если есть references/learned-patterns.md — на него стоит ссылка в теле SKILL.md (конвенция skill-learning)
• [ ] Файл в framework/skills/, агенты обновлены, install.py --list показывает навык

depends_on: []