fix(skills): audit descriptions — trim routing prose, fix stale facts, add missing triggers (#1990)

* fix(skills): audit descriptions — trim routing prose, fix stale facts, add missing triggers

Descriptions are the always-loaded routing tier; this audit rebuilds them on
one principle: discriminate by input shape, not pipeline internals.

- Trim creation-workflow descriptions to positive trigger + nearest-neighbor
  disambiguation + /hyperframes escape hatch; full routing prose already
  lives in each skill body's route-confirm block and the router
- Codify the workflow-vs-domain split as ownership (owns the end-to-end
  deliverable vs capability layer pulled in mid-flight) in /hyperframes,
  and widen "make me a video" framing to deck / composition port
- Fix stale facts: embedded-captions identity count (desc 32, body 17 →
  actual 36 = 10 classic + 26 themed), six→ten visual languages, retired
  RVM/Standard wording in router details, figma shader transport
  (MCP → MCP source / native export), keyframes "cursor demos" (no backing
  content), hyperframes-media scripts/audio.mjs leak
- Register missing capabilities: motion-graphics maps category (was in
  categories/ but absent from its own table, description, and router),
  asset-fusion + news triggers, slideshow page-to-deck + presenter mode,
  general-video editing, talking-head-recut 16:9/9:16/4:5 canvas,
  cli feedback + lambda sites, product demos, mood-brief BGM generation
- website-to-video: relabel promo-shaped video types to keep the promo
  boundary with /product-launch-video; drop headless-Chrome wording
- music-to-video: lyric timing via /hyperframes-media transcription or
  user-supplied lyrics, placed on the beat grid
- Sync catalogs in lockstep (CLAUDE.md, AGENTS.md, README,
  docs/guides/skills.mdx, CLI project templates): add music-to-video +
  slideshow entries, complete the domain-skill lists, and extend the
  catalog-maintenance rule to cover AGENTS.md and the templates

Validated with a 35-case description-only routing eval: 35/35 both before
and after the rewrite (including new maps / asset-fusion / news probes).

* fix(skills): post-media-v2 consistency — stale media ref, router figma wording, catalog rows

- music-to-video: lyric transcription now routes to /media-use (the
  retired /hyperframes-media was still referenced)
- router capability map: figma row gains the shaders fact (MCP source /
  native export), matching the SKILL.md source of truth
- media-use catalog rows (CLAUDE.md, README, docs/guides/skills.mdx):
  add image models + captioning, aligning with the v2 description
- catalog rule #1: root AGENTS.md carries the workflow list only (it
  has no domain-skill section) — rule wording now says so
This commit is contained in:
WaterrrForever
2026-07-07 14:28:46 +08:00
committed by GitHub
parent 3d8372f880
commit 306a291dea
24 changed files with 130 additions and 125 deletions
+16 -18
View File
@@ -1,17 +1,14 @@
---
name: motion-graphics
description: >
Use when the user wants a short, design-led motion graphic where motion is the
message: kinetic typography, stat or number count-up, chart/data-viz hit,
logo sting, brand lockup, lower-third, callout, social overlay, animated
headline/tweet/news item, motion poster, or quick captured-page highlight.
Usually under 10s and up to ~30s, with no narration arc, voice-over, or
live-action subject. Can render to MP4 or transparent overlay. Not for longer,
multi-scene, narrated, or brand-reel pieces (use general-video), narrated
website videos (website-to-video), topic explainers
(faceless-explainer), product promos (product-launch-video), PR videos
(pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a
quick motion-first piece or a longer / narrated treatment, see /hyperframes.
A short, design-led motion graphic where motion is the message — kinetic
typography, stat count-up, chart/data-viz hit, logo sting / brand lockup,
lower-third / callout / social overlay, animated map (highlight regions,
connect places, zoom to a location), animated tweet / news-article /
headline, webpage / UI animation (scroll, cursor, callouts), or fusing a
real image's geometry into a chart. Usually under 10s (up to ~30s), no
narration or live-action subject; renders to MP4 or transparent overlay.
Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.
metadata:
{
"tags": "orchestrator, motion-graphics, kinetic-type, data-viz, logo-reveal, lower-thirds, news, tweet, webpage, asset-fusion, short-form, overlay, no-narration",
@@ -42,13 +39,14 @@ A short design-led motion graphic. **Asset-first**: decide the asset strategy an
**Form categories — no search; the user supplies the content:**
| Category | Intent | Leans on |
| -------------- | ---------------------------------------------- | --------------------------------------------------------------------------- |
| `kinetic-type` | punchy line / quote / title, motion-first text | `caption-*` blocks + animation rules |
| `stat` | single hero number / count-up + ring | `apple-money-count` / `rules/{counting-dynamic-scale, stat-bars-and-fills}` |
| `charts` | bar / line / pie / race / % from data | `data-chart` block |
| `logo-reveal` | logo sting / brand lockup (user logo) | `logo-outro` / `rules/svg-path-draw` |
| `lower-thirds` | name / title bars, callouts, social overlays | `caption-*` + registry overlay blocks |
| Category | Intent | Leans on |
| -------------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `kinetic-type` | punchy line / quote / title, motion-first text | `caption-*` blocks + animation rules |
| `stat` | single hero number / count-up + ring | `apple-money-count` / `rules/{counting-dynamic-scale, stat-bars-and-fills}` |
| `charts` | bar / line / pie / race / % from data | `data-chart` block |
| `logo-reveal` | logo sting / brand lockup (user logo) | `logo-outro` / `rules/svg-path-draw` |
| `lower-thirds` | name / title bars, callouts, social overlays | `caption-*` + registry overlay blocks |
| `maps` | geographic motion — highlight regions, connect places, zoom to a location (vector lane, or baked basemap lane) | `us-map` / `world-map` family + `bake-basemap.mjs` |
**Search-driven categories — search first, then animate by content type** (the RWA path):