Explainer Illustrations

Marketplace listing update: added the launch explainer film (`media.demo_video_url`). No code, schema, copy or guidance changes; hero and screenshots unchanged from 0.2.2.

Packaging-only release. No change to the skill's guidance, recipes, references, registry or scripts — the shot-list behaviour of 0.2.1 is untouched.

### Fixed
- **`skills[0].visibility` flipped `internal` → `public`.** The package shipped at `tier: beta` (customer-visible) but the inner skill entry stayed `internal`, which silently hides the skill from the surface that matters. `tier: beta` alone does not publish a skill — the inner `visibility` has to agree with it.

### Added
- **Top-level `media:` block** — `hero_image_url` + 3 `screenshots`, so the marketplace card renders with real assets instead of empty slots. All four are durable `media.spideriq.ai` URLs in the approved house style (dark board, white chalk, single gold accent), reused from the launch post rather than re-rendered. `demo_video_url` is deliberately omitted; an empty string fails validation.
- **`marketing.features[]`** — 5 verb-led bullets covering the plan-first loop, the one-anchor rule, the brand-fidelity gate, the regulated-claim gate, and the no-backend guarantee. The field was previously empty on the live manifest.

Closes the remaining findings from the 2026-07-09 propagation report (a live off-brand illustration set + wasted render attempts). v0.2.0 had the right shape but missed the *approved* specifics.

### Added
- **`references/di-atomic-brand-tokens.md`** — the approved Di-Atomic (brand 2) house style: dark board `#131313` · white ink · single gold `#EEBF01` · Inter · **default pack = `whiteboard-sketch` recolored to the dark board** (NOT clean-line-art). The seeded `visual_style`; never invent.
- **New learning** `2026-07-09-di-atomic-house-style-and-gate-auth`.

### Changed
- **Recall is now a HARD STOP gate** (hard rule 3): recall the brand's `visual_style` first; if none exists, STOP and ask — do not invent a look. (The rejected set was invented `#0f2540`/`#e0a83b`.)
- **Hard rule 6** now requires: render ONE test frame → VIEW it → only then the full set; VIEW every frame; **agent-browser the live placement** before "done". An API 200 is not verification.
- **`rendering-via-spidergate.md` auth corrected** — the image gate REJECTS an OPVS PAT (401); it needs a **SpiderIQ 3-part token with image entitlement** (media-generator resolves it). Added the real-world gotchas: `/v1/models` aliases fail on `/images/generations` (use plain `gpt-image-1`/`dall-e-3`); Python gets Cloudflare 1010 (use curl); rate-throttle; b64_json → SpiderMedia upload → durable URL.
- All 6 recipes now name the Di-Atomic house default (dark-board whiteboard-sketch) instead of defaulting to clean-line-art.

Brand-fidelity + render-mechanics hardening — driven by a real agent failure (invented palette, text-only render, raw provider curls, base64 instead of hosted URL). The skill was too gentle; these are now hard, concrete rules.

### Added
- **`references/brand-style-resolution.md`** — MANDATORY step ❷: pull the brand's REAL tokens (Di-Atomic brand 2 = gold `#EEBF01` + Inter, never invented), LOOK at its existing illustrations (agent-browser), pick the matching pack, grab a **style reference image**. The brand's own illustrations override the generic style-pack exemplars.
- **`references/rendering-via-spidergate.md`** — the ONLY render mechanic: media-generator `generateImage` → SpiderGate Mode A (`spideriq.ai/api/gate/v1`) / Mode B (`get_next_available_key('kieai')` + Nanobanana keep-constant). Reference image → Mode B. Structured keep-constant YAML prompts only. Durable `media.spideriq.ai` URL, never base64/provider URL. `verify-brand-consistency` gate.
- **`scripts/verify-brand-fidelity.mjs`** — new enforcement: real tokens (flags the invented `#0f2540`/`#e0a83b` hexes), a `style_reference_url` per shot, `mode_hint: kie` when a reference exists, no base64/provider-URL leakage.
- **3 learnings** from the real failure: `brand-fidelity-needs-reference-image`, `never-hand-roll-provider-calls`, `durable-url-not-base64` (learnings 14 → 17).

### Changed
- **SKILL.md hard rules** now 6 (was 5): rule 3 = resolve-brand-style-first + reference-anchored render; rule 5 = render ONLY via media-generator/SpiderGate, no raw curls/free-text, durable-URL-not-base64; rule 6 = verify brand fidelity before "done".
- SKILL.md flow adds step ❷ BRAND (resolve real style) + the shot list now carries `brand_id` / `brand_tokens` / `style_reference_url` per shot; default `mode_hint: kie` for branded sets.
- All 6 recipes gained a "Resolve brand style" step + `verify-brand-fidelity` + the post-render `verify-brand-consistency --brand=<id>` + `verify-all` gate.
- `tier: beta` (customer-visible; vendor-set convention 2026-07-09).

Patch: make the durable-hosting step explicit. Rendered provider URLs (DALL-E/Kie/FAL) are ephemeral; the durable asset is the `media.spideriq.ai` CDN URL that media-generator returns after `upload-host-media` (`@spideriq/media-skills`) persists it to SpiderMedia.

### Added
- `@spideriq/media-skills >=0.1.0` declared as a peer (the SpiderMedia hosting layer, reached via media-generator).
- `instructions/DEPLOYMENT.md` §Hosting — the ephemeral→durable URL contract + the upload-host-media flow diagram.
- SKILL.md flow steps ⓫ HOST + ⓬ PERSIST, with a MUST note: persist/hand on only the durable `media.spideriq.ai` URL, never a provider URL.
- New learning `2026-06-17-ephemeral-vs-durable-urls`.
- All 6 recipes' persist steps now specify the durable URL.

### Notes
- This skill still does NOT upload itself — media-generator owns `upload-host-media` (Rule 5/7). explainer-illustrations consumes the durable URL it returns.

Initial release. Guidance-only skill — the planning brain between copy and render.

### Added
- **SKILL.md router** — decision tree (content type → anchors → shot list → style pack → prompts → handoff → QA) + 5 hard rules.
- **12 references** — cognitive-anchor-extraction, shot-list-planning, composition-patterns, image-prompt-template, 5 style packs (clean-line-art, whiteboard-sketch, isometric-tech, corporate-flat, editorial-illustration), multilingual-annotations, compliance-vocabulary-gate, qa-checklist.
- **6 recipes** — blog-article-illustrations, case-study-deep-dive, tutorial-walkthrough, changelog-release-notes, social-carousel, pitch-deck-explainers.
- **39 registry items** — evidence-bundled (each with a live source URL + measurable signal): methodology/principles, style-pack exemplars, composition patterns, KPI metrics, + 6 real social teardowns (scrapecreators: Reddit r/coolguides·r/dataisbeautiful·r/Infographics + YouTube, with per-post engagement numbers).
- **13 learnings** — institutional-memory entries (anchor-first, no-locked-character, in-image-text-latin-only, style-pack-mismatch, isometric-saturation, canvas-per-recipe, set-consistency, shot-list-before-render, decorative-in-adjectives, compliance-vocab-in-text, model-prompt-behavior, pedagogical-order, + the explainer engagement-signature finding from real teardowns).
- **4 enforcement scripts** — verify-shot-list-quality, lint-decorative-vs-explanatory, verify-anchor-presence, verify-coordination (PASS/FAIL with numbers).
- **instructions/** — AGENTS.md (non-Claude runtimes) + DEPLOYMENT.md (downstream handoff contract to media-generator / post-writer / section-designer).
- **Coordination (v2.2)** — agentboard / agentdocs / agentmemory / opvs-protocol cross-references.
- **EN language floor.** DE/FR/RO/RU/HE planned for v0.2.0 (in-image text is Latin-only; non-Latin uses the overlay path).

### Notes
- Methodology adapted from an MIT upstream (Chinese-language); attribution preserved in `source/`. The proprietary character IP and example renders were intentionally dropped; the single locked style was generalized into 5 style packs.
- Execution: **guidance-only** (no schema.yaml, no methods, no backend). Render is handed to `@di-atomic/media-generator`.

### Planned (v0.2.0)
- Full multilingual: DE / FR / RO (in-image) + RU / HE (overlay).
- Two more recipes: `compliance-explainer`, `client-success-story` (research already done).