Skill Creator

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

Нужно создать новый скилл (team-skills / shared-skills / personal-skills), подключить его к текущему проекту и опционально — ко всем проектам на машине.

Правила (must follow)

1. Скиллы — только SKILL.md + references/. Никаких бинарников, venv, node_modules. Если скиллу нужен Python-скрипт — он в scripts/ (рядом с SKILL.md); запускать его общим окружением скиллов $env:SKILLS_PY ($SKILLS_RUNTIME/.venv), а НЕ venv проекта — скилл подключается к разным проектам. Нужна новая библиотека — добавить в $SKILLS_RUNTIME/requirements.txt. Бинари (exe) — в $SKILLS_RUNTIME/tools\<имя>\. 1a. Скилл использует секрет → рядом со SKILL.md обязателен README.md по настройке. Что за секрет, где его взять, куда положить (канон — %USERPROFILE%\.claude\skills.env либо свой *.env вне репозиториев), как проверить одной командой, таблица «симптом → причина» и раздел про безопасность. Плюс *.env.example с ключами без значений. Секреты НЕ хранить в конфигах чужих проектов: скилл, читавший <другой проект>/config/.env, молча переставал работать на машине без этого проекта. Образцы: skills-rag/README.md, skills-rag/README.md.
2. Шаблон — _TEMPLATE/SKILL.md из того репо, куда кладётся скилл. _TEMPLATE есть в team-skills, shared-skills и personal-skills.
3. Описание (description) во frontmatter ≤ 1024 символов. Это единственное, что Claude читает до активации скилла — оно должно содержать и что делает, и ключевые триггер-слова (через точку или запятую).
4. Контур скилла = репо, куда класть:
   • team-skills ($TEAM_SKILLS_HOME) — corp-проекты (корп-проекте, ttt): знание кодовой базы, SAP, Kafka, SQL Server
   • shared-skills ($SKILLS_HOME) — универсальные: git, youtube, cleaner, skill-creator
   • personal-skills ($PERSONAL_SKILLS_HOME) — личные: настройки машины, личные проекты
   • Если сомневаешься — спроси пользователя.
5. Коммит прямо в master целевого репо (team/shared/personal — все flat). Формат: <имя-скилла>: <описание>.
6. Линковка — skills-link.ps1 из того же репо (параметры: -Contour, -ProjectPath, -SyncAll). Для текущего проекта: & $SKILLS_HOME\skills-link.ps1 -ProjectPath <проект>. Для всех проектов — -SyncAll: он сам находит проекты, где уже есть .claude\skills\ с junction'ами, и перелинковывает каждый по ЕГО контуру (corp-проекты не получат personal-скиллы). Инкрементально: новые скиллы добавятся, существующие пропустятся. Ручной цикл по проектам не нужен.

Процедура

1. Уточнить параметры скилла

Спроси пользователя (один вопрос со всеми пунктами):

• Имя скилла (kebab-case, например excel-lineage)
• Репо (team/shared/personal) — если контур неясен, предложи вариант и объясни почему
• Что делает — 1-2 предложения для description (≤1024 символов)
• Триггер-слова — через что Claude будет поднимать скилл (5-15 слов/фраз)
• Нужны ли scripts/ или references/ — если да, какие файлы

Не начинай писать, пока пользователь не подтвердит параметры.

2. Создать структуру

$repo = "$SKILLS_HOME"  # или team-skills, personal-skills
$name = "<имя-скилла>"
$dir = "$repo\skills\$name"
New-Item -ItemType Directory -Force -Path "$dir\references" | Out-Null
# scripts/ — только если нужен
if (<нужны скрипты>) { New-Item -ItemType Directory -Force -Path "$dir\scripts" | Out-Null }

3. Написать SKILL.md

Скопируй структуру из $repo\skills\_TEMPLATE\SKILL.md:

---
name: <имя-скилла>
description: <что делает + триггер-слова, ≤ 1024 символов>
---

# <Название>

## Когда применять
<1-3 строки: конкретные ситуации>

## Правила (must follow)
<нумерованный список императивных правил>

## Процедура
<пошагово: что и в каком порядке делать>

## Данные (если скилл пишет данные)
<про git pull перед работой и git add/commit/push после записи данных>

## Если скилл подвёл
Заметку в `feedback/YYYY-MM-DD.md`: что ожидал, что оказалось.

Критические требования к SKILL.md:

• description во frontmatter — ТОЛЬКО одна строка, без переносов
• Правила — императивные ( «делай X», не «вам следует делать X»)
• Процедура — чёткие шаги с кодом и путями
• Никаких «TBD», «потом допишем», «возможно»

4. Написать references/ (если нужны)

Каждый reference-файл — короткий, конкретный. Название — kebab-case. В SKILL.md сошлись на него: «детали — references/имя.md».

5. Зафиксировать в git

git -C $repo add skills/$name/
git -C $repo commit -m "$($name): новый скилл — <одна строка описания>"
git -C $repo push origin master

6. Подключить к проектам

Текущий проект (обязательно):

& $SKILLS_HOME/skills-link.ps1 -ProjectPath <путь-к-проекту>

Все проекты (спросить пользователя): Спроси: «Подключить скилл ко всем проектам?» Если да — один вызов, ручной цикл не нужен:

& $SKILLS_HOME/skills-link.ps1 -SyncAll

-SyncAll находит проекты, где уже есть .claude\skills\ с junction'ами, и перелинковывает каждый по ЕГО контуру — изоляция сохраняется сама (personal-скилл в corp-проект не попадёт). Скилл-репо в выборку не попадают.

Проект без маркера контура в CLAUDE.md скрипт отвергает с ошибкой «Контур не задан» — это НЕ сбой линковки: контур не угадывать, спросить пользователя. Проект без .claude\skills\ вообще -SyncAll не увидит — такой линковать адресно через -ProjectPath. Но сначала проверь, нужен ли ему свой контур: проект может вестись из другого (напр. <проект-А> ведётся из <проект-Б> и своего CLAUDE.md намеренно не имеет) — тогда линковать нечего.

7. Проверить

# Убедиться что скилл виден
Get-ChildItem <проект>\.claude\skills\<имя-скилла>

Доложи: имя скилла, где лежит (репо + путь), к каким проектам подключён.

Данные

Скилл сам не пишет проектные данные. При каждой активации допиши строку <дата> skill-creator <проект> в $SKILLS_HOME/data\usage.log, затем git -C $SKILLS_HOME add data/usage.log && git -C $SKILLS_HOME commit -m "usage: skill-creator" && git -C $SKILLS_HOME push origin master.

Если скилл подвёл

Заметку в feedback/YYYY-MM-DD.md (в папке этого скилла): что ожидал, что оказалось.