skill-creator-ext

---
name: skill-creator-ext
description: >
  1C BSL Framework extension for skill-creator skill.
  Use together with the base skill-creator skill when creating or modifying
  framework skills (bsl-practices, tool-usage, spec-writing, agent-development-ext, etc.).
  Covers: framework skill categories, tool-usage skills replacing tool-registry,
  BSL content patterns, 1c-ai-agent-cli integration, project-specific skills.
---

# Skill Creator — 1C BSL Framework Extension

> **Базовый навык:** `skill-creator` (Anthropic).
> Сначала прочитай базовый навык — он содержит общие принципы создания skills.
> Этот файл добавляет **только** 1С-специфику фреймворка.

---

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

| Триггер | Действие |
|---------|----------|
| Появился новый MCP tool, и агент не знает КОГДА его использовать | Создать `tool-usage/` skill |
| Обнаружен повторяющийся антипаттерн в BSL-коде | Создать `bsl-practices/` skill |
| Нужно обучить агента специфике конкретной конфигурации | Создать **проектный** skill (в каталоге IDE проекта) |
| Нужна стандартная методология (SDD, TDD, ревью) | Создать `spec-writing/` или новый подкаталог |
| Нужно адаптировать внешний навык под фреймворк | Создать `*-ext/` расширение |

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

---

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

| Категория | Каталог | Назначение | Примеры |
|-----------|---------|------------|---------|
| **BSL-практики** | `skills/bsl-practices/` | Стандарты кодирования и паттерны | `coding-standards`, `query-patterns` |
| **Tool-usage** | `skills/tool-usage/` | Когда и как использовать MCP-инструменты | `syntax-checking`, `metadata-discovery`, `test-execution` |
| **Spec-writing** | `skills/spec-writing/` | Стандарты документации и спецификаций | `spec-standard` |
| **Расширения** | `skills/*-ext/` | Расширения внешних skills (Anthropic и др.) | `agent-development-ext`, `skill-creator-ext` |

### Расширения (-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 предложения назначения
   - **Когда применять** — таблица триггер → действие
   - **Сценарии** — конкретные примеры
   - **Примеры кода** — правильно + неправильно с объяснением ПОЧЕМУ
4. **Интеграция:** файл в `framework/skills/`, обновить `skills` в агентах, `python tools/install.py --list`

---

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

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

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

```markdown
# [Название] — как использовать MCP-инструменты для [задачи]

## Когда применять

| Триггер | Действие |
|---------|----------|
| Пользователь просит проверить синтаксис | Вызвать `bsl.checkSyntax(uri)` |
| Агент написал/изменил .bsl код | Автоматически проверить синтаксис |

## MCP-инструменты

| Инструмент | Назначение | Workarounds |
|------------|------------|-------------|
| `bsl.checkSyntax` | Проверка синтаксиса | Если URI не найден — проверить encoding |

## Сценарии
[Конкретные цепочки вызовов]
```

### Принципы

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

---

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

| Тип | Размещение | Frontmatter | Установка |
|-----|-----------|-------------|-----------|
| Framework skill | `framework/skills/` | `name`, `description`, `depends_on` | CLI через симлинки |
| IDE skill | `.cursor/skills/` или `.agents/skills/` | `name`, `description` | `npx skills add` |
| Расширение (-ext) | `framework/skills/<name>-ext/` | `name: base-name-ext`, `description` | CLI, часть фреймворка |

---

## 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)
- [ ] Файл в `framework/skills/`, агенты обновлены, `install.py --list` показывает навык

---
depends_on: []
---