sheleg-design-skill 1.56.0 → 1.57.0

package/CHANGELOG.md

@@ -6,6 +6,71 @@ follow [SemVer](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.57.0] - 2026-08-30
+
+### The siblings are declared, the maps are derived, the descriptions stop scarring
+
+Five closures from the family audit of 2026-08-29 (SHD-05, SHD-01, SHD-03, SHD-09,
+SHD-11), one release.
+
+**The three sibling skills are declared, and every one has a written absent-branch
+(SHD-05, the audit's HIGH).** `SKILL.md` handed charts to a `dataviz` skill that
+exists on no consumer machine this skill ships to, and asserted `shadcn` /
+`migrate-radix-to-base` "are installed" — a promise this repository has no way to
+keep. Three changes, none of them a removal:
+
+- A `compatibility` front-matter line names all three as optional siblings with
+  in-text fallbacks — the Agent Skills field for environment expectations, spent on
+  the one expectation this skill actually has.
+- The chart handoff is now conditional in both homes: where a `dataviz` skill is
+  installed it consumes the pack as its parameter set, and **where none is
+  installed, the role table in `SURFACE_COMPOSITION.md` IS the chart contract**,
+  applied by hand — which is what that table always was, stated instead of implied.
+- The component-layer section says what absence costs: nothing. `npx shadcn@latest
+  add` does the adding without the skill, and the token mapping binds either way.
+
+**Every long reference now carries a derived `## Contents` list (SHD-01).** The
+authoring rule — a reference over 100 lines carries a map, because that is what a
+partial read sees — held in 2 of 46 qualifying files. Hand-adding 44 lists creates
+44 lists that rot, so the list is **derived**: `scripts/gen_contents.py` writes the
+entries from the file's own `## ` headings (fenced code blocked out), `--write`
+regenerates bundle + mirror + template source together, and
+`validate_contents_lists()` refuses a file whose list is missing *or drifted* —
+including the one pre-existing list whose entries had already wandered from the
+headings they mapped (`MOBILE_SURFACES.md`). A new pack without a Contents list now
+fails the gate with the remedy in the message.
+
+**Both host-facing manifest descriptions are generated, never hand-appended
+(SHD-03).** `plugin.json` and the plugin entry in `marketplace.json` had converged
+to what per-release appending always produces: `patchbay` and `nameplate` glossed
+twice, `deskmate` never glossed, and `chorus` carrying `deskmate`'s orphaned
+parenthesis. Both descriptions are now derived from `STYLE_PACK_INDEX.md`'s
+catalogue — the register and good-fit columns packs are already chosen by — via
+`scripts/gen_manifest_descriptions.py` (`npm run gen-descriptions`), and
+`validate_manifest_descriptions()` refuses a manifest that differs from the
+derivation. The generator also refuses to run when the catalogue and `styles/`
+disagree, so the index parity gate fires first, not silently.
+
+**The deck trigger names the register it owns (SHD-09).** "investor deck" /
+«презентация» was broad enough to catch every presentation request, including the
+`.pptx` files the pptx/pitch-deck neighbours own. Now: *"investor deck as a web
+page" / "веб-презентация"*, with the file-based register explicitly declined in the
+description tail. The T1 carrier word `deck` survives, and the umbrella advertises
+no presentation trigger for this skill, so no routing hook loses a word.
+
+**The layout deviation is recorded where a retrofit would look (SHD-11).**
+References at the skill root and tokens two levels deep predate the layout
+guidance, and every deep link, the `.cursor` byte-mirror and `install.sh`'s file
+list depend on them. CONTRIBUTING.md now records the deviation as deliberate so the
+next standards pass reads a decision instead of an accident.
+
+Gate: 5060 → 5598 checks (the floor moves with it); both new checks watched
+failing against the real tree first — 46 references and 2 manifests red before the
+regeneration, green after — and each ships a planted defect in the self-test. The
+Contents gate's first live catch was the next release's own file: v1.56.0's
+`MOTION_PRODUCTION.md` landed mid-flight without a list, and the rebase gate
+refused it until `npm run gen-contents` wrote one.
+
 ## [1.56.0] - 2026-08-30
 
 ### The render seam — what changes when motion stops being a page

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheleg-design-skill",
-  "version": "1.56.0",
+  "version": "1.57.0",
   "description": "Design taste as an installable agent skill. Cinematic scroll-driven landing pages built on one scroll clock and layered degrade-to-calm motion, a motion doctrine that decides whether to animate before it decides how, three calibration dials, and thirty-nine locked style packs with ready-made design tokens — instrument-console, editorial-luxury, workbench, briefing-room, atrium, orchard, outrank, babylove, patchbay, nameplate, field-notes, cyclorama, showroom, blueprint, prism, maquette, scoreboard, datasheet, manpage, pigeonhole, roster, ora, tenor, paperclip, ledger, router, daylight, notation, almanac, vitrine, proscenium, awning, bulletin, rimlight, onionskin, deskmate, test-drive, surveyor and chorus. Colour, slop and fork-reciprocity gates run as scripts, not opinions. Works with Cursor, Claude Code and any agent that reads a SKILL.md.",
   "bin": {
     "sheleg-design-skill": "bin/cli.js"
@@ -24,6 +24,8 @@
     "smoke": "node bin/cli.js --help",
     "palette": "python3 test/validate_palette.py",
     "sync-kits": "python3 scripts/sync-kit-tokens.py",
+    "gen-descriptions": "python3 scripts/gen_manifest_descriptions.py --write",
+    "gen-contents": "python3 scripts/gen_contents.py --write",
     "sloplint": "python3 test/sloplint.py",
     "selftest": "python3 test/validate.py --self-test && python3 test/validate_palette.py --self-test && python3 test/sloplint.py --self-test"
   },

package/plugins/sheleg-design/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "sheleg-design",
   "displayName": "SHELEG Design",
-  "description": "SHELEG Design methodology: cinematic scroll-driven landing pages (single scroll clock, layered degrade-to-calm motion, WebGL particle formations), a motion doctrine that decides whether to animate before it decides how, and thirty-nine pluggable visual style packs — instrument-console (dark console), editorial-luxury (warm editorial), workbench (light/dark product UI for dashboards and tools), briefing-room (dark 16:9 deck), atrium (warm consumer health), orchard, outrank, babylove (friendly consumer biotech), patchbay (a dark live schematic: one mint-cyan, 8% hairlines and no shadow, and an architecture diagram whose cords carry SMIL particles), field-notes (warm paper for dev tools sold on auditability), cyclorama (a pastel field on a 32s cycle), showroom (the product as the exhibit), blueprint (a drawing sheet, zero radius), prism (one iridescent wash over mono body), maquette (cream axonometric models on a dark table), scoreboard (warm paper, pixel numerals, a dark ledger of results), datasheet (an off-white spec sheet whose live instrument goes dark when it detects the reader is hiding), manpage (a developer landing page set in the reader's own system monospace on cream paper, with coral label chips that are real headings and a dark code frame as the argument), pigeonhole (a white sorting wall whose nine pastel categories are a filing scheme rather than a mood, each a two-layer chip whose label word is mandatory), roster (a white field in a faint grid of squares whose argument is other people's marks — client logotypes in pill-labelled industry columns, an engine's wordmark inside the headline — where the proof is a name rather than a number), ora (a warm coal field with cream ink and no third hue — the accent is the inverted field — a serif carrying every human sentence over a monospace carrying every machine fact, a terminal surface cut below the page, and a six-step verdict ramp, for products whose output is a machine's verdict about the reader), tenor (warm paper with zero radius and zero shadow, one hairline weight, an orange that exists only on hover and on focus, a sans tracked negative against a mono tracked positive, display at a line-height below one in an eight-to-twelve-character measure, and product proof delivered as silent looping video, for products arguing that a new kind of thing must be managed like an existing organisation), paperclip (neutral coal with no functional colour at all — every control monochrome and elevation made of hairlines, with the whole chromatic budget spent on a curtain of gradient capsules and twelve gradient section badges that cannot be clicked — for products that ask a person to run something that runs itself: agent teams, autonomous back-office, schedulers and budget-governed compute), ledger (warm cream paper ruled by a hairline at 12% ink and no shadow on any card, radius 15 nested concentrically, an ink primary button and a terracotta accent that never fills a control — it labels, as a 10px monospace uppercase kicker — with a seal on every card stating how its number is known, for the console of a product that answers questions about data: AI analysts, BI surfaces, query workspaces), router (a near-white field with a trace of blue and white cards standing on it, hairline seams instead of shadows anywhere, body at 14px and weight 450, and a status triplet in which the colour you paint with is not the colour you write with, for product consoles and the landing pages that have to look like them), daylight (a cool near-white portal field with generous radii and one very large soft shadow spent on a single object per screen, for client portals), notation (a near-white page drawn entirely in hairlines with a light serif over a monospace, no bold anywhere and an ink primary, for developer products sold on restraint), almanac (oatmeal paper with 2px seams and no 1px anywhere, a display set below a line-height of one, and mono tags notched through drawn boxes, for pages that assert a category), vitrine (a white hairline field with a serif display, an ink primary and one framed record carrying the evidence, for the front door of a product sold on trust). Ships the sheleg-design skill, the architecture reference, the motion doctrine, the Figma and Claude Design bridges, AI-surface patterns, style packs with ready-made token CSS, and the /sheleg-design command, and awning (a white forecourt where the accent is black and no hue reaches the chrome at all, a pill whose radius is a declared component token, one variable grotesque at 420/550 with no 700, and a single three-layer shadow, for commerce and platform front doors), and proscenium (a white field carrying two cool acts and one deep indigo act at the middle, an electric violet filling a control that stays nearly square at 4px against cards at 16, one family at nine weights, and a framed product panel the fold cuts off, for product-led marketing front doors whose argument is a demonstration), and bulletin (warm cream paper cut by flat pastel bands, every card and control a 1px ink outline standing on a hard zero-blur ink offset it travels into when pressed, a display face at 800 inside controls and 700 in the headline, and no tracking at any size, for front doors whose argument is breadth), and nameplate (a cool near-white slab under a page that is square on 87% of its elements, where the one round shape is reserved for a white 1px-bordered pill carrying somebody else's publication name as type, one family with the body at weight 500, and two uppercase registers tracked 0.06em and 0.175em, for pages whose argument is that named third parties will vouch for you: press placement, trust marks, certification and review aggregation), and rimlight (a white field with a cool grey act separator and one near-black act, a grotesque for every sentence and a monospace for every piece of chrome, square on 84% of its elements and tracked negative at every size, whose only elevation is a sixteen-layer coloured light rig — six layers lit and ten held at alpha 0, thrown from below-left — for a studio's own front door and the pages that sell what it makes), and onionskin (a white technical sheet at 96.5% zero radius — the squarest page in the library — where two bases do all the work and everything quiet is one of them at an alpha: text dims through the ink, structure dims through a navy that is never a word, over a dot grid with dashed hairlines and three faces at an 11px working size, for developer and AI infrastructure whose front page is a working document), deskmate, test-drive, surveyor, and chorus (warm off-white paper under a faint construction grid with a crosshair at every intersection, where the set piece is somebody else's question in a cut-corner bubble — 24px on three corners and 0 on the top right — over near-black slabs cut into the sheet, one coral that fills but never writes, and a periwinkle that only exists inside a gradient, for AI-search visibility, brand monitoring and community marketing whose proof is other people's conversations) (a warm beige working day lit from one source above the top edge, where a single four-stop ramp — peach, lilac, violet, deep navy — washes the field, fills a panel and fills one word of a heading, everything a hand touches is a pill at 56px and everything else a 32px slab, elevation is a field step with two shadows on a 10,211px page, and the set piece is a framed transcript whose quoted chat client keeps its own face, ink and status colours under a --quoted-* namespace, for products sold as a colleague rather than a tool: AI employees and chat-native agents).",
-  "version": "1.56.0",
+  "description": "SHELEG Design methodology: cinematic scroll-driven landing pages (single scroll clock, layered degrade-to-calm motion, WebGL particle formations), a motion doctrine that decides whether to animate before it decides how, and thirty-nine pluggable visual style packs, each with a ready-made token layer — instrument-console (near-black aerospace console; technical systems and infrastructure), editorial-luxury (cream and espresso; editorial, research, premium B2B), workbench (quiet light/dark UI; dashboards, admin, internal tools), briefing-room (dark 16:9 deck; investor and board presentations), atrium (cream daylight; consumer health and high-trust DTC), babylove (white with orange; SEO SaaS, long time-to-value, disconnected states), patchbay (black with mint-cyan; engines, buses, pipelines, OSS front doors), nameplate (cool slab with coral; press, certification and third-party trust), rimlight (white with blue light; studios, services and case studies), onionskin (white working sheet; developer and AI infrastructure), deskmate (warm beige with a dusk bleed; AI coworkers and chat-native agents), test-drive (warm paper with one coral; self-serve SaaS proven by the live product), surveyor (peach paper with teal and pink; visibility, monitoring and benchmark tools), chorus (warm paper under a crosshair grid, with a cut-corner bubble; AI-search visibility, brand monitoring and community marketing), outrank (white with violet; one brand across marketing and product), orchard (warm oat slabs; friendly biotech and wellness), field-notes (ruled green paper; auditable open-source developer tools), showroom (white gallery; product-led companies selling the app), blueprint (white technical stock; vector, storage and query infrastructure), prism (iridescent hard edge; command-first OSS infrastructure), maquette (near-black table; enterprise data infrastructure), cyclorama (looping pastel field; applied-AI consultancies), scoreboard (warm paper; growth, ads and accumulating metrics), datasheet (off-white specification; fraud, identity and device intelligence), manpage (cream manual; APIs, SDKs, CLIs and MCP servers), pigeonhole (filed white field; inbox, ticket and CRM triage), roster (faint square grid; platforms sold through who uses them), ora (warm coal; machine verdicts, audits and protocol traces), tenor (warm management paper; agent operations and autonomous back office), ledger (cream ruled console; analysts, BI and warehouse agents), paperclip (monochrome coal; orchestrators, schedulers and job runners), awning (white commerce forecourt; storefront, payroll and billing platforms), router (pale console with hairlines; dashboard, billing and inventory surfaces), daylight (bright portal with one shadow; client onboarding and service portals), notation (restrained technical hairlines; OSS, docs and developer workspaces), almanac (oatmeal editorial paper; manifestos and category-defining pages), vitrine (serif trust display; evaluated B2B, security and compliance), proscenium (white demo sequence; product tours and launch pages), bulletin (cheerful outlined bands; broad SMB and agency platforms). Ships the sheleg-design skill, the architecture reference, the motion doctrine, the Figma and Claude Design bridges, AI-surface patterns, the packs' token CSS, and the /sheleg-design command.",
+  "version": "1.57.0",
   "author": {
     "name": "ssheleg",
     "url": "https://x.com/sshlg93"

package/plugins/sheleg-design/skills/sheleg-design/AI_PRODUCT_PATTERNS.md

@@ -14,6 +14,19 @@ and states, not a palette. Every token named here is workbench's.
 
 ---
 
+## Contents
+
+- 1. The five states of a model call
+- 2. Streaming beats spinners
+- 3. Latency has two numbers
+- 4. Provenance and uncertainty
+- 5. Agent actions: the confirm is the design
+- 6. Empty states carry the capability
+- 7. Chat is a shape, not the shape
+- 8. Cost, quota and scope
+- 9. Bans
+- Evidence
+
 ## 1. The five states of a model call
 
 Design all five before building any. Most AI UI ships state 2 and 3 only, then

package/plugins/sheleg-design/skills/sheleg-design/DESIGN_SYNC_BRIDGE.md

@@ -15,6 +15,16 @@ agent that does not have it — the pack stands on its own and nothing below app
 
 ---
 
+## Contents
+
+- 1. What crosses, and in what shape
+- 2. Style packs — the pack is the source of truth
+- 3. Figma — one border at a time
+- 4. Reference sweeps (Lazyweb, Mobbin, Refero) — layout crosses, identity does not
+- 5. Live-site extraction — the pack first, the sync second
+- 6. What cannot cross
+- 7. Round-trip discipline
+
 ## 1. What crosses, and in what shape
 
 A kit ships **three layers**, and they are a stack rather than a menu:

package/plugins/sheleg-design/skills/sheleg-design/FIGMA_BRIDGE.md

@@ -15,6 +15,13 @@ stands on its own and nothing below applies.
 
 ---
 
+## Contents
+
+- 1. Code → Figma (publish the pack as variables)
+- 2. Figma → code (implement a design without importing slop)
+- 3. What cannot cross
+- 4. Round-trip discipline
+
 ## 1. Code → Figma (publish the pack as variables)
 
 Use when a project has the pack in code and needs the design file to match — or

package/plugins/sheleg-design/skills/sheleg-design/MOBILE_SURFACES.md

@@ -9,7 +9,7 @@ pack's `## Responsive` section covers that, and this file does not repeat it.
 
 - What a pack decides here, and what it does not
 - The six rules every pack already carries — and one no pack answers
-- Reference sweeps (Lazyweb, Mobbin) — structure crosses, identity does not
+- Reference sweeps — structure crosses, identity does not
 
 ## What a pack decides here, and what it does not
 

package/plugins/sheleg-design/skills/sheleg-design/MOTION_DOCTRINE.md

@@ -8,6 +8,20 @@ Every number here is a decision someone else already paid for. Use them.
 
 ---
 
+## Contents
+
+- 1. Should this animate at all?
+- 2. Easing
+- 3. Duration
+- 4. Springs
+- 5. Forbidden forms
+- 6. Scroll motion
+- 7. Motion that came from a design tool
+- 8. Anti-drift
+- 9. Reduced motion
+- 10. Pre-flight
+- How the calibration dials bind
+
 ## 1. Should this animate at all?
 
 The first question is not "what animation" — it is "how often will a person see

package/plugins/sheleg-design/skills/sheleg-design/MOTION_PRODUCTION.md

@@ -9,6 +9,16 @@ plays.
 That is a different medium with different physics, and treating it as "the same
 animation, exported" is the mistake this document exists to prevent.
 
+## Contents
+
+- The boundary
+- Before the tool: what a rendered asset costs
+- The two tools, measured
+- The recommendation, and the three conditions that reverse it
+- The token seam
+- Reduced motion, on the other side of the render
+- Pre-flight for a rendered asset
+
 ## The boundary
 
 | The motion is… | It belongs to | Read |

package/plugins/sheleg-design/skills/sheleg-design/SHELEG_DESIGN.md

@@ -26,6 +26,25 @@ build new sites on the same principles and understand *why* each piece works.
 
 ---
 
+## Contents
+
+- 0. The one-paragraph thesis
+- 1. Architecture at a glance
+- 2. Layer 1 — The scroll store (the single clock)
+- 3. Layer 2 — Smooth scroll (one position per frame)
+- 4. Layer 3 — The particle field (the scene-formation engine)
+- 5. Layer 4 — The 2D fallback (SignalMesh)
+- 6. Layer 5 — The projection bridge (fusing DOM and WebGL)
+- 7. Layer 6 — DOM choreography
+- 8. Layer 7 — Reveal primitives (act-themed entrances)
+- 9. Layer 8 — Scrubbed instruments (GSAP recipe)
+- 10. Cross-cutting rules
+- 11. Recipe — build a new SHELEG site from scratch
+- 12. Why it works (the deeper principles)
+- 13. File map (one file per idea)
+- Quick reference — each rule, and the failure it prevents
+- Three looks that are defaults, not decisions
+
 ## 0. The one-paragraph thesis
 
 A landing page feels "alive" not because it has many animations, but because a

package/plugins/sheleg-design/skills/sheleg-design/SKILL.md

@@ -1,9 +1,10 @@
 ---
 name: sheleg-design
-description: Use when deciding how something LOOKS or MOVES — cinematic landing pages and hero sections, particle/WebGL backgrounds, scroll-linked or scrubbed motion, layers that drift, dashboards, admin or internal tools, mobile screens, chat or agent interfaces, tokens, themes, palettes, typography and the Figma border. Triggers include "design a landing" / "дизайн лендинга", "build a landing page" / "сделай лендинг", "scroll animation" / "скролл-анимация", "dashboard style" / "стиль дашборда", "design tokens, style pack" / "дизайн-токены", "light/dark theme" / "светлая/тёмная тема", "figma variables" / "переменные фигмы, фигма в код", "mobile screen" / "мобильный экран", "palette, colors" / "палитра, цвета", "typography, font" / "типографика, шрифт", "how it looks, make it prettier" / "выглядит, красиво, красивее", "visual reference" / "визуальные референсы", "investor deck" / "презентация". Not for structure, copy or backend behavior.
+description: Use when deciding how something LOOKS or MOVES — cinematic landing pages and hero sections, particle/WebGL backgrounds, scroll-linked or scrubbed motion, layers that drift, dashboards, admin or internal tools, mobile screens, chat or agent interfaces, tokens, themes, palettes, typography and the Figma border. Triggers: "design a landing" / "дизайн лендинга", "build a landing page" / "сделай лендинг", "scroll animation" / "скролл-анимация", "dashboard style" / "стиль дашборда", "design tokens, style pack" / "дизайн-токены", "light/dark theme" / "светлая/тёмная тема", "figma variables" / "переменные фигмы, фигма в код", "mobile screen" / "мобильный экран", "palette, colors" / "палитра, цвета", "typography, font" / "типографика, шрифт", "how it looks, make it prettier" / "выглядит, красиво, красивее", "visual reference" / "визуальные референсы", "investor deck as a web page" / "веб-презентация". Not for structure, copy, backend behavior, or .pptx decks.
 license: MIT
+compatibility: Optional siblings — dataviz, shadcn, migrate-radix-to-base; each has an in-text fallback when absent.
 metadata:
-  version: 1.56.0
+  version: 1.57.0
 ---
 
 # SHELEG Design
@@ -156,10 +157,14 @@ as a definition of done, in that order:
 - **Scene depth — six layers** ([`SURFACE_COMPOSITION.md`](./SURFACE_COMPOSITION.md)),
   before writing CSS for a cinematic page. A scene has planes; everything on one
   plane is the failure no amount of easing repairs.
-- **Charts — hand the pack to `dataviz`** (same file), before drawing a chart in
-  any pack. Token names are not uniform across the thirty-nine packs — only `--bg`
-  and `--ink` resolve in every one — and an undefined custom property does not error,
-  it silently falls back. Guessing one is the quietest way to ship a wrong chart.
+- **Charts — the role contract in the same file, plus the `dataviz` handoff
+  where that skill exists**, before drawing a chart in any pack. Token names are
+  not uniform across the thirty-nine packs — only `--bg` and `--ink` resolve in
+  every one — and an undefined custom property does not error, it silently falls
+  back. Guessing one is the quietest way to ship a wrong chart. A `dataviz`
+  skill is an optional neighbour this skill does not ship: where none is
+  installed, the role table in `SURFACE_COMPOSITION.md` IS the chart contract,
+  applied by hand.
 - **Mobile surfaces** ([`MOBILE_SURFACES.md`](./MOBILE_SURFACES.md)), when the
   brief is a native app screen or a mobile-web view — not a desktop page whose
   only mobile concern is collapse. Five mobile rules the packs each state alone,
@@ -232,9 +237,13 @@ there, the work is bespoke scroll and WebGL, and reaching for a component kit is
 how a hero ends up looking like a settings screen.
 
 **Who does the work.** This section decides *whether* and *against which tokens*.
-The `shadcn` skill does the adding, searching and composing, and
-`migrate-radix-to-base` handles the Radix→Base move; both are installed and
-trigger on their own words. Do not restate their component docs here.
+Where the `shadcn` skill is installed it does the adding, searching and
+composing, and `migrate-radix-to-base` handles the Radix→Base move; both are
+**optional neighbours** this skill declares in its `compatibility` line and does
+not ship, and they trigger on their own words where present. Where they are
+absent nothing is blocked: the kit's own CLI (`npx shadcn@latest add
+<component>`) does the adding, and the token mapping above binds either way. Do
+not restate their component docs here.
 
 ## Optional — Figma (design ↔ code)
 

package/plugins/sheleg-design/skills/sheleg-design/SURFACE_COMPOSITION.md

@@ -53,9 +53,15 @@ A pack that bans grain and blur leaves the slot empty rather than filling it —
 
 ## Charts and data — hand the pack to `dataviz`
 
-Do not restyle charts from the pack by hand, and do not let a chart library pick
-its own colours. The `dataviz` skill already owns chart form, colour roles and
-the runnable palette validation; a pack is the *parameter set* it consumes.
+Do not let a chart library pick its own colours. Where a `dataviz` skill is
+installed, it owns chart form, colour roles and the runnable palette validation,
+and a pack is the *parameter set* it consumes — hand it the values mapped below.
+That skill is an **optional neighbour**: this skill declares it in its
+`compatibility` front-matter and does not ship it, so its absence is an ordinary
+state, not a broken install. **Where no dataviz skill is installed, the role
+table below is the contract** — resolve each role from the chosen pack's token
+layer by hand, and the status map and the two rules at the end of this section
+bind exactly the same, with nobody to hand them to.
 
 **Read the chosen pack's own token names before you write a single `var()`.**
 This table is by *role*, not by token, because the names are not uniform across

package/plugins/sheleg-design/skills/sheleg-design/styles/STYLE_PACK_TEMPLATE.md

@@ -36,6 +36,24 @@ were chosen because their answers are **derived from the token layer**, so the
 gate re-derives both and refuses a declaration that has drifted from the thing
 it describes. Add a third only when it can be answered the same way.
 
+## Contents
+
+- Before you fill anything — six rules that decide whether this pack is real
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor (optional — cinematic packs only)
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Before you fill anything — six rules that decide whether this pack is real
 
 Until 1.11.0 these were spread across three places a reader of the installed

package/plugins/sheleg-design/skills/sheleg-design/styles/almanac.md

@@ -16,6 +16,22 @@ Contract: widened — all thirteen headings.
 Themes: light + dark — a full theme twin.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose Almanac for **pages that assert a category**: a company saying *this is

package/plugins/sheleg-design/skills/sheleg-design/styles/atrium.md

@@ -20,6 +20,23 @@ already measured. Read on 2026-08-20 from `/_astro/utilities.*.css` and
 Themes: light only — no second block of any kind ships here.
 Rank: unordered — 3 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor (cinematic packs only)
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for **consumer health and premium care**: longevity and

package/plugins/sheleg-design/skills/sheleg-design/styles/awning.md

@@ -26,6 +26,18 @@ the pack forgot. Everything the pack does state is binding.
 Themes: light only — no second block of any kind ships here.
 Rank: unordered — 3 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Motion tokens
+- Signature motifs
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for a **commerce or platform front door** — the surface that

package/plugins/sheleg-design/skills/sheleg-design/styles/babylove.md

@@ -20,6 +20,23 @@ priced, and the price is legible in both directions: `outrank` gets a semantic
 vocabulary and inherits somebody else's upgrade path; this gets a system a person
 holds in their head and no answer at all for a second theme.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Plain, warm, unhurried. The product is patient with itself — it ships a *What to

package/plugins/sheleg-design/skills/sheleg-design/styles/blueprint.md

@@ -16,6 +16,23 @@ Contract: widened — all thirteen headings.
 Themes: light only — no second block of any kind ships here.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor (cinematic packs only)
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for **infrastructure sold on precision**: vector databases,

package/plugins/sheleg-design/skills/sheleg-design/styles/briefing-room.md

@@ -21,6 +21,18 @@ citation attached — which is the one thing this pack layer exists to prevent.
 Themes: light only — no second block of any kind ships here.
 Rank: unordered — 1 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Motion tokens
+- Signature motifs
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for **presentations rendered as a product**: investor and

package/plugins/sheleg-design/skills/sheleg-design/styles/bulletin.md

@@ -19,6 +19,22 @@ Contract: widened — all thirteen headings.
 Themes: light only — the second block (`[data-surface="ink"]`) is a SURFACE variant, not a theme twin.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose Bulletin for **front doors whose argument is breadth** — a tool that does

package/plugins/sheleg-design/skills/sheleg-design/styles/chorus.md

@@ -29,6 +29,22 @@ Contract: widened — all thirteen headings.
 Themes: light only — the dark slab is a SURFACE variant (`.chorus-slab`), not a theme twin; the page never inverts.
 Rank: unordered — 3 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose Chorus for **products whose proof is other people's conversations** —

package/plugins/sheleg-design/skills/sheleg-design/styles/cyclorama.md

@@ -18,6 +18,23 @@ Contract: widened — all thirteen headings.
 Themes: light only — no second block of any kind ships here.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor (cinematic packs only)
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for **a company selling transformation to an executive buyer**:

package/plugins/sheleg-design/skills/sheleg-design/styles/datasheet.md

@@ -21,6 +21,23 @@ Contract: widened — all thirteen headings.
 Themes: light only — the second block (`[data-state="alarm"]`) is a SURFACE variant, not a theme twin.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Motion flavor
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose this pack for **B2B SaaS whose product is a verdict about the visitor, the

package/plugins/sheleg-design/skills/sheleg-design/styles/daylight.md

@@ -15,6 +15,22 @@ Contract: widened — all thirteen headings.
 Themes: light + dark — a full theme twin.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose Daylight for **client-facing portals and the pages that sell them**:

package/plugins/sheleg-design/skills/sheleg-design/styles/deskmate.md

@@ -30,6 +30,22 @@ Contract: widened — all thirteen headings.
 Themes: light only — the second block (`[data-surface="dusk"]`) is a SURFACE variant, not a theme twin.
 Rank: unordered — 4 status role(s) and no severity ramp; a rank scale is yours.
 
+## Contents
+
+- Register
+- Palette
+- Type
+- Texture & surface
+- Components
+- Hero
+- Responsive
+- Motion tokens
+- Signature motifs
+- Signature element
+- Micro-interactions
+- Bans
+- Gotchas
+
 ## Register
 
 Choose Deskmate for **products sold as a colleague rather than a tool** — AI employees