skill-forge

# skill-forge A compass, not a dictator. This skill helps you **design** skills that are maximally **technological** (engineered, reliable, composable), **creative** (generative, varied, distinctive), and **aesthetically disciplined** (intentional, not templated). It separates the *obligatory base* — rules you must not break — from *accents* — amplifiers you choose per task. > Russian triggers: `создай скил`, `новый скил`, `улучши скил`, `сделай скил > креативнее`, `эстетичный скил`, `технологичный скил`, `скилл шаблонный`, > `перепиши SKILL.md`, `мета-скилл`, `проверь скилл перед релизом`. ## Level 0 — Hard rules (the base, never break these) These come from the official Agent Skills specification (agentskills.io) plus our own working gates. They are **non-negotiable**. - **Frontmatter**: `name` (≤64 chars, `a-z 0-9 -`, no double hyphens, MUST match the folder name) and `description` (≤1024 chars, MUST state *what* the skill does AND *when* to use it). Put all "when to use" info in `description`, never in the body. Make triggers a little "pushy" to fight undertriggering — list synonyms and casual phrasings. - **Progressive disclosure**: keep `SKILL.md` under 500 lines. Bundle code in `scripts/` (deterministic, repetitive tasks), docs in `references/` (loaded as needed; add a TOC if >300 lines), outputs in `assets/`. Reference files one level deep only. - **Voice**: write in the imperative. Explain the *why* instead of heaped MUST/ ALWAYS/NEVER — all-caps...