feat(skills): link every skill to the examples that prove it

10 of 16 skills linked no example, and an agent had to join three
manifests to learn what an example runs, on which Blender, and how to
break it.

- examples/skills.json (hand-edited) maps each of the 64 examples to
  the skills it proves; 52 map to at least one.
- scripts/build_examples_index.py generates examples/index.json: one
  record per example with script, skills, render or check-only,
  min_version, run command, one-line summary, every smoke falsifier with
  its expected exit, and the README exit-code table.
- The same script writes a marked "Runnable examples" section into each
  SKILL.md, with an absolute link, summary and one falsifier per example.
  addon-scaffolding, bl-info-migration and ui-panels say no example
  exists yet and point at #378.
- --check runs in Validate and tests/run_all.py. It fails when an
  example is unmapped, a skill name is unknown, a skill has no example
  and is not pending, or the generated files are stale.
- CLAUDE.md and docs/new-example-prompt.md add the mapping to the wiring
  list.

Gallery version badges and a "falsify it" line on detail pages are left
for a follow-up.

Refs #377

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: TMHSDigital

.github/workflows/validate.yml

@@ -326,6 +326,9 @@ jobs:
       - name: Check claude/blender-rules.md and the rules skill are regenerated from rules/*.mdc
         run: python3 scripts/build_claude_rules.py --check
 
+      - name: Check examples/index.json and each skill's Runnable examples section are regenerated
+        run: python3 scripts/build_examples_index.py --check
+
       - name: Check the plugin-dist build assembles, carries every skill, and stays slim
         run: python3 scripts/build_plugin_dist.py --check
 

CLAUDE.md

@@ -124,10 +124,10 @@ example still carries a `tests/smoke/catalog.json` row and a falsifier.
 gallery's source of truth. When authoring a new gallery example, copy the anatomy of
 `examples/bmesh-gear/` (script structure, README shape, dark-studio render recipe) and
 wire all of: gallery.json entry (with an `alt` sentence describing the still; the build fails without one),
-a `tests/smoke/catalog.json` row, hero webp (1280×720) in
+a `tests/smoke/catalog.json` row, an `examples/skills.json` entry naming the skills it proves (`python scripts/build_examples_index.py` then regenerates `examples/index.json` and each skill's Runnable examples section; Validate fails on a missing entry), hero webp (1280×720) in
 `docs/gallery/assets/` + its 640×360 card variant `<name>-hero-640.webp` (`python scripts/make_thumbs.py`; the gallery build exits 5 without it) + preview webp (1200×675), then run `python scripts/build_gallery.py`.
 A check-only example wires only the
-`tests/smoke/catalog.json` row and its README — it is deliberately absent from
+`tests/smoke/catalog.json` row, its `examples/skills.json` entry, and its README — it is deliberately absent from
 `examples/gallery.json` and `docs/gallery/`.
 Renders must conform to the gallery look spec at `docs/VISUAL-STYLE.md`.
 Render paths gate framing through the shared helper `examples/gallery_framing.py` —

docs/new-example-prompt.md

@@ -97,10 +97,12 @@ shape from neighboring examples and repository configuration, including the exam
 directory, README, gallery metadata and assets, plugin manifest, smoke catalog
 (`tests/smoke/catalog.json`, whose row must list the falsifier under
 `falsifiers` with its exact `expect_exit` so CI re-proves it on every run),
+the skills mapping (`examples/skills.json`, then `python scripts/build_examples_index.py`
+to regenerate `examples/index.json` and the skills' Runnable examples sections),
 the top-level README's aggregate counts (it no longer carries a per-example
 row; the gallery is the catalog), and generated gallery pages. A
 check-only example skips the gallery metadata, assets, and generated pages — it wires
-the plugin manifest, the smoke catalog row, and its README, and nothing else. After regenerating the gallery with
+the plugin manifest, the smoke catalog row, the skills mapping, and its README, and nothing else. After regenerating the gallery with
 `python scripts/build_gallery.py`, read the **generated** output character by
 character—not only `examples/gallery.json` source fields. Open
 `docs/gallery/index.html` and `docs/gallery/<name>/index.html` and inspect the