skill-forge · diff

git:20260814.5023d8c to git:20260814.06fa906

13 added, 0 removed. Audit A to A.

---

name: skill-forge

description: >

Peer-local skill forge — create a local-<skill> on THIS node (local autonomy lane) and prepare

its promotion into the shared skill set through a gate. Use when a new skill idea appears on a

follower machine and shouldn't wait for the hub. Trigger on "/skill-forge <idea>".

permissions: [filesystem]

risk_level: shell-local

processes_untrusted_data: false

disable-model-invocation: false

origin: MAC-1

related: decision-2026-07-14-fleet-skill-autonomy-local-namespace

license: MIT

---

# skill-forge — кузница скиллов пира (Ось А + гейт промоушена)

Реализация одобренного дизайна [[decision-2026-07-14-fleet-skill-autonomy-local-namespace]]:

пир создаёт СВОИ скиллы локально (никого не «отравляет», радиус поражения чужих = 0),

а на общий набор флота попадает только через гейт. Пока `local-*` — живёт только здесь

(`.stignore local-*`, не синкается, не откатывается receiveonly, но грузится loader'ом).

Привратник: `skill_guard.py` в этой же папке (0-LLM, stdlib). Рельсы из DR26-07-14-MAC-1-01.

---

## Режим A — `/skill-new` (создать local-скилл)

1. **Имя** — `local-<slug>`, только `[a-z0-9-]`. Проверить:

`python ~/.claude/skills/skill-forge/skill_guard.py --check-name local-<slug>`

2. **Скаффолд**: создать `~/.claude/skills/local-<slug>/SKILL.md` с frontmatter:

- `name`, `description` (когда вызывать), `permissions: [...]` (filesystem/shell/network — что реально нужно),

`risk_level` (inert / shell-local / shell-networked / secret-touching / always-loaded-core / irreversible — таксономия ChatGPT-DR),

`processes_untrusted_data: true|false`, `disable-model-invocation: true` для side-effect/ручных.

- ⚠️ **shell OFF по умолчанию**: не проси `shell` без реальной нужды; скилл с shell → обязательный review при промоушене.

3. **Гейт-скан** сразу: `python ~/.claude/skills/skill-forge/skill_guard.py`

(рельс 1 collision + рельс 3 sync-conflict — узнаешь сразу, не шадоуишь ли общий скилл).

4. **`/tt`** новый скилл (прогнать вживую → сломать → доказать) ДО любого промоушена.

## Режим B — `/skill-promote` (local → общий набор флота)

Гейт (одобрен Антоном): **`/tt` + leak-scan + collision-check + risk-classify + 1 мнение пира → маршрут писателю.**

Follower НЕ пишет общий набор сам (он receiveonly) — готовит бандл и отдаёт единственному писателю.

1. **Гейт детерминированно** (всё, что можно проверить машиной, здесь и сейчас):

```

python ~/.claude/skills/skill-forge/skill_guard.py --leak local-<slug>

```

→ collision (рельс 1) + sync-conflict (рельс 3) + name (Step 2) + leak (рельс 6). Exit 1 = стоп.

Тяжёлый leak-scan при наличии — `gitleaks`/`trufflehog` поверх (движок `/release-slice`).

2. **`/tt` пройден?** — без ✅ не промоутим.

3. **Risk-класс** → если `secret-touching` / `always-loaded-core` / `irreversible` / trigger Tier-2 →

**гейт Антона** (QQQ в 02), иначе — 1 мнение пира достаточно.

4. **1 мнение пира** — `bus_send.py <peer> "SKILL-REVIEW: local-<slug> …"` ([[peer-opinion-before-fleet-rollout]]).

5. **Маршрут писателю**: скопировать бандл в `_machine-bus/_transit/canon-proposals/` + пинг писателю

(сейчас = хаб; после Step 3 миграции = Якорёк). Писатель снимает `local-`, коммитит, синкает всем

([[skills-rollout-all-machines-default]]). ⛔ Сам `local-` не снимаю на follower — это работа писателя.

---

## Границы (что НЕ делает этот скилл)

- **Step 3 (перенос писателя hub→Якорёк)** — fleet-консенсус, НЕ отсюда.

- **Step 5 (кодификация в Библию/CLAUDE.md)** — канонический писатель (хаб), ПОСЛЕ сборки механизма.

- **OS-read-only на shared/** (вызов B из DR) — инфра узла, отдельно от этого скилла.

🧒 Простыми словами: это верстак, чтобы придумать свой инструмент прямо у себя, проверить, что

он не ломает чужие и не прячет секрет, а потом отдать «главному кузнецу», который раздаёт всем.

+ ---

+

+ ## About & contact

+ Built and battle-tested at **Palo Alto AI Research Lab** — a fleet of Claude Code machines

+ running 24/7 as a second brain and synthetic cofounder. Every skill here survived real

+ production use before publication.

+ - 📦 All 101 skills: https://github.com/tonydzi/second-brain-starter-kit

+ - 👤 Author: **Anton Dziatkovskii** — Telegram [@tonydzi](https://t.me/tonydzi) · WhatsApp [+1 341 222 9178](https://wa.me/13412229178) · X [@Tony_Stef_](https://x.com/Tony_Stef_)

+ - 🧪 **Engineers: want to test-drive this setup?** Message me — I hand out free starter seeds to engineers who test and report back. Custom skill requests welcome.