pattern-languagelisted
Install: claude install-skill petar-djukic/writing-skills
# Pattern language (mine materials, write the YAML)
This skill turns a repository's materials into a `pattern-language.yaml` in
the Alexandrian tradition: not a catalogue of tips but a *language* — each
pattern names a field of forces and the configuration that resolves them, and
the grammar connects each pattern to the ones that create its context and the
ones that complete it.
## Where things live
- **Format:** `references/format-spec.md` — the schema (header block,
top-level keys, entry keys, grammar semantics, quality bar), distilled from
the three existing instances.
- **Method:** `references/mining-guide.md` — forces-first extraction, the
confidence rubric, disqualifiers, ordering, sizing.
- **Skeleton:** `assets/template.yaml` — copy to start a new language; it
validates as-is.
- **Validator:** `scripts/validate_language.py <file>` — structural checks
(keys, unique ids/numbers, grammar resolution, cites, connectivity);
`--fix-plan` adds a concrete suggested edit per finding (read-only).
## Known instances (study before writing)
| File | Role |
|---|---|
| `declarative-agents/design-patterns/pattern-language.yaml` | the canonical: 11 build-time patterns, full field set, rich external examples |
| `agent-failure-modes/aaai-2027/pattern-language.yaml` | extends the canonical (`da:` prefix); paper scaffolding with `paper` bindings |
| `agent-failure-modes/ieee-tse/pattern-language.yaml` | paper scaffolding with `paper_sections`/`experiments`; delegates cit