diff --git a/dist/writing-skills.skill b/dist/writing-skills.skill index e3118e1..1e112fb 100644 Binary files a/dist/writing-skills.skill and b/dist/writing-skills.skill differ diff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.md index f400803..7db5c7f 100644 --- a/skills/writing-skills/SKILL.md +++ b/skills/writing-skills/SKILL.md @@ -1,7 +1,7 @@ --- name: writing-skills adapted-from: obra/superpowers @ 6.2.0 (MIT) — TDD-for-skills core; ideya 8 self-skill-authoring (workshop record) -version: 0.1.1 +version: 0.2.0 description: > Authoring agent skills TDD-style — RED-GREEN-REFACTOR applied to SKILL.md documents. Use when creating a new skill, editing an existing one, or @@ -89,9 +89,21 @@ content for hypothetical cases. ### Skill structure (our catalog conventions) ``` -skills//SKILL.md +skills//SKILL.md # общий каталог (catalog, версионируется, ставится install.sh) ``` +**Куда класть скил — определи ДО написания (три варианта, не путать):** + +| Тип скила | Место | Когда | +|---|---|---| +| Общий каталог | `~/projects/skills/skills//SKILL.md` + deploy (lint/build/install) | полезен всем проектам/агентам | +| **Проектный (зона проекта)** | `/.agents/skills//SKILL.md` (pi грузит из cwd; Claude Code: `.claude/skills/`) | привязан к одному проекту/роли (пример: `.admin` ops-скилы, `books/.agents/skills/`) | +| ~~Глобальная установка руками~~ | ~~`~/.agents/skills/`~~ | **НЕ сюда** — это установочная копия (перезапишется update-skills), не место разработки | + +Правило: если скил про зону одного проекта (admin, books, …) — проектный путь +(`.agents/skills/` в cwd проекта), НЕ общий каталог и НЕ `~/.agents/skills/`. +Если скил общий — каталог `skills/` + deploy-цикл. При сомнении — спросить. + Frontmatter (YAML): - `name` — letters, numbers, hyphens only. Verb-first, active voice: @@ -158,6 +170,8 @@ discipline skills. - [ ] Description = when to use only, no workflow summary - [ ] Frontmatter: name (verb-first, hyphens), description (triggers), version (bumped), provenance (author/adapted-from with real pin) +- [ ] Placement decided: project skill → `/.agents/skills/` (cwd), NOT + `~/.agents/skills/`; catalog skill → `skills//` + deploy cycle - [ ] Lint passes (catalog: `scripts/lint-skills.py`), dist rebuilt (`scripts/build.sh`), installed (`scripts/install.sh `) - [ ] README provenance table updated (catalog)