feat(skill): writing-skills v0.2.0 — placement rule: проектный скил → .agents/skills/ (cwd), не ~/.agents/skills/ и не каталог

This commit is contained in:
2026-08-26 10:18:27 +03:00
parent e81217388e
commit 931330bf31
2 changed files with 16 additions and 2 deletions

Binary file not shown.

View File

@@ -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/<name>/SKILL.md
skills/<name>/SKILL.md # общий каталог (catalog, версионируется, ставится install.sh)
```
**Куда класть скил — определи ДО написания (три варианта, не путать):**
| Тип скила | Место | Когда |
|---|---|---|
| Общий каталог | `~/projects/skills/skills/<name>/SKILL.md` + deploy (lint/build/install) | полезен всем проектам/агентам |
| **Проектный (зона проекта)** | `<project>/.agents/skills/<name>/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 → `<project>/.agents/skills/` (cwd), NOT
`~/.agents/skills/`; catalog skill → `skills/<name>/` + deploy cycle
- [ ] Lint passes (catalog: `scripts/lint-skills.py`), dist rebuilt
(`scripts/build.sh`), installed (`scripts/install.sh <name>`)
- [ ] README provenance table updated (catalog)