sheleg-design-skill 1.61.2 → 1.61.3

package/CHANGELOG.md

@@ -1,3 +1,52 @@
+## 1.61.3 — every borrowed rule names its source, and the motion tools agree with the doctrine
+
+`MOTION_DOCTRINE.md` §1–4 is Emil Kowalski's animation doctrine almost word for word
+(the frequency table with its Raycast example, the easing tree, the three curves with
+their comments, the duration rows, both spring notations), and `KNOWLEDGE_PROVENANCE.md`
+had no row for `emilkowalski/skills`. The same was true of the three calibration dials
+(`Leonxlnx/taste-skill`) and the "three default looks" paragraph (`anthropics/skills`
+`frontend-design`), while row 6 pointed at `julianoczkowski/designer-skills`, whose file
+carries none of those looks. The file's own rule is "a source path, a SHA and a
+permalink, or it is not adopted"; it was not being kept.
+
+- **Provenance, 6 → 16 rows.** Rows 1–5 re-pinned to `pbakaus/impeccable@12b25ae` (only
+  `SKILL.md` changed bytes); row 6 kept and re-verified, with a note on what it did and
+  did not inform; rows 7–9 for the impeccable type, layout and finish-review files
+  `CREATIVE_DIRECTOR.md` already cited (now linked at the same commit); rows 10–14 for
+  `emilkowalski/skills@e8a175d`; row 15 for `taste-skill@e3c9203`; row 16 for
+  `anthropics/skills@2235be7`, the version installed when the looks section was
+  written. Three rows are `adapted`, so the MIT notices (Emil Kowalski, Leonxlnx) and an
+  Apache-2.0 notice now travel in the file, and each adapted passage names its source
+  where it sits, the condensed Cursor rule included.
+- **Emil's skills are tools inside the lanes, not a second entry point.**
+  `MOTION_DOCTRINE.md` §11 names `review-animations`, `improve-animations`,
+  `find-animation-opportunities`, `animate`, `animate-expo` and `apple-design`, and says
+  that `emil-design-eng` loads by itself; `MOBILE_SURFACES.md` names `mobile-native` and
+  `animate-expo`; `VISUAL_REVIEW.md` names `break-ui` for worst-case data before a
+  populated capture; `MOTION_PRODUCTION.md` says none of them reads a render timeline.
+- **Eleven rules reconciled, one value each** (table in `KNOWLEDGE_PROVENANCE.md`). The
+  doctrine changes four: no `ease-in` exit exception; the default spring is
+  `duration 0.4, bounce 0` with bounce only after a flick; `transition: all` and
+  entrances from `scale(0)` are banned; under reduced motion an opacity or colour change
+  that carries state may stay. It keeps its modal and drawer ceiling (200–300 ms;
+  500 ms only for a mobile sheet) against the tool's 200–500 ms, which contradicts the
+  tool's own under-300 rule, and the Cursor rule's stale `200–500ms` line is corrected
+  to match. `MOBILE_SURFACES.md` rule 1 now gives a hero `100svh` and an app shell
+  `100dvh`; the 28 packs that write `100dvh` are B-139.
+- **D7 text defects.** A bold lead sentence in `SKILL.md` said twice in a row, and the
+  "Three looks" section of `SHELEG_DESIGN.md` pasted twice with two Contents lines, the
+  second copy linking to itself. One copy of each is kept.
+- **The class, not only the instances.** `scripts/gen_contents.py` refuses a repeated
+  `## ` heading (a derived list derives the duplicate too, so drift never saw it), with a
+  validator plant; `test/sloplint.py` refuses the same sentence twice in a row, watched
+  failing on the pre-fix `SKILL.md`, and requires the `transition: all`, `scale(0)` and
+  "never a second entry point" text; `test/audit_regressions/xd-01.01.py` adds four
+  checks (permalink agrees with its row, adapted rows carry a notice, the reconciliation
+  is recorded, the looks name their source), three watched failing on the pre-fix files.
+
+The `SKILL.md` body is 4746/4750 tokens after the edit (house auditor at `5ca5c36`).
+Whether models follow the reconciled values was not measured.
+
 ## 1.61.2 — rendered copy is part of visual review
 
 Visual review now inspects headings, hero fragments, captions and labels against

package/cursor/rules/sheleg-design.mdc

@@ -163,24 +163,31 @@ Frequency decides before taste gets a vote. (Full doctrine:
   consistency, state indication, feedback, explanation, or preventing a jarring
   cut. "It looked cool" is not an answer; if you cannot write the sentence,
   delete the animation.
-- **`ease-in` is banned in UI.** It starts slow, in the exact moment the user is
-  watching hardest. Entering or leaving → `ease-out`; moving or morphing on
+- **`ease-in` is banned in UI**, exits included. It starts slow, in the exact moment
+  the user is watching hardest. Entering or leaving → `ease-out`; moving or morphing on
   screen → `ease-in-out`; hover or colour change → `ease`; constant motion →
   `linear`. Curves: `--ease-out: cubic-bezier(.23,1,.32,1)`,
   `--ease-in-out: cubic-bezier(.77,0,.175,1)`,
   `--ease-drawer: cubic-bezier(.32,.72,0,1)`.
 - **UI motion stays at or under 300 ms.** Button press 100–160ms · tooltip 125–200ms ·
-  dropdown 150–250ms · modal/drawer 200–500ms. Marketing and scrollytelling are
-  deliberately longer.
+  dropdown 150–250ms · modal/drawer 200–300ms; only a full-height mobile sheet may run
+  to 500ms. Marketing and scrollytelling are deliberately longer.
+- Springs: `{ type: "spring", duration: 0.4, bounce: 0 }` by default; bounce 0.1–0.3
+  only after a flick or a drag release.
 - Never animate a property that triggers layout (`width`, `height`, `top`,
   `left`, `padding`, `margin`, `gap`, `font-size`). Never a bare scroll
   listener, never `requestAnimationFrame` writing component state, never
   `backdrop-filter` or grain on a scrolling container, never a left-behind
-  `will-change`, never two marquees.
+  `will-change`, never two marquees, never `transition: all` (name the properties),
+  never an entrance from `scale(0)` (start at `scale(0.95)` with `opacity: 0`).
 - **Reduced motion is a contract, not a feature.** Anything beyond a colour
   change honours `prefers-reduced-motion: reduce`; loops, parallax and springs
-  collapse to static or instant, never to "slower". Shipping an animation
-  without that branch is a bug, not a polish item.
+  collapse to static or instant, never to "slower"; an opacity or colour change that
+  carries state may stay. Shipping an animation without that branch is a bug, not a
+  polish item.
+- This section is adapted from `emilkowalski/skills` (MIT License, Copyright (c) 2026
+  Emil Kowalski); the full notice ships in the skill's `KNOWLEDGE_PROVENANCE.md` and
+  at https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/LICENSE.
 
 ## Five principles, in order
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheleg-design-skill",
-  "version": "1.61.2",
+  "version": "1.61.3",
   "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 \u2014 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"

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

@@ -3,7 +3,7 @@
   "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, 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.61.2",
+  "version": "1.61.3",
   "author": {
     "name": "ssheleg",
     "url": "https://x.com/sshlg93"

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

@@ -384,9 +384,9 @@ binary, service, API key, font download or new framework. Reuse local assets and
 existing inspection tools; missing inspection remains NOT_RUN.
 
 These local procedures were informed by a comparison of Impeccable's
-[type](https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/typeset.md),
-[layout](https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/layout.md)
-and [finish-review methods](https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/degraded/finish-reviewer.md) (Apache-2.0). They use this family's contracts; no
+[type](https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/typeset.md),
+[layout](https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/layout.md)
+and [finish-review methods](https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/degraded/finish-reviewer.md) (Apache-2.0). They use this family's contracts; no
 upstream runtime, assets, fixed style bans or automatic workflow are included.
 The links record provenance, not instructions to fetch during every run.
 

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

@@ -13,25 +13,95 @@ verified.
 this pack. Platform guidance (iOS, Android) is **paraphrased from the primary
 platform documentation in our own words**, not copied from a third party, until
 that third party's MIT notice has been verified and attached — so the rows below
-are *evidence a method exists and works*, never instruction authority and never
-a source whose text was vendored.
+are *evidence a method exists and works*, never instruction authority. Where a
+row is `adapted`, text did come across, and its licence notice travels with it
+in this file.
+
+## Contents
+
+- Adopted sources
+- Transfer rules (apply the moment a row becomes `adapted`)
+- Reconciliation with the installed motion tools
+- Third-party notices
+- What is NOT in the knowledge package
 
 ## Adopted sources
 
 | # | Source (commit-pinned) | Path | SHA256 of reviewed file | Kind | Verified | Permalink |
 |---|---|---|---|---|---|---|
-| 1 | pbakaus/impeccable @ `4db7f6ba4b6ef661bc8a721261b691b40648c08a` | `plugin/skills/impeccable/SKILL.md` | `53cd1dec43ab49a9bfb31a1f47c1b231dbe1d3ed04e5fcfa3569be2579040291` | derived | 2026-09-07 | https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/SKILL.md |
-| 2 | pbakaus/impeccable @ `4db7f6ba4b6ef661bc8a721261b691b40648c08a` | `plugin/skills/impeccable/reference/ios.md` | `40c87038b5f75147a5952a96237acf312a327bf70c1bcd8e0a5f064625ae9668` | derived | 2026-09-07 | https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/ios.md |
-| 3 | pbakaus/impeccable @ `4db7f6ba4b6ef661bc8a721261b691b40648c08a` | `plugin/skills/impeccable/reference/android.md` | `058f81f256134841875fd3183e06b37a023de0c877fd2b9eecd97011640791fe` | derived | 2026-09-07 | https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/android.md |
-| 4 | pbakaus/impeccable @ `4db7f6ba4b6ef661bc8a721261b691b40648c08a` | `plugin/skills/impeccable/reference/adapt.native.md` | `17c583cf8ad41266ea1e787b666b9d91fe13469d3d0f6af57c08e0146f9b17ac` | derived | 2026-09-07 | https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/adapt.native.md |
-| 5 | pbakaus/impeccable @ `4db7f6ba4b6ef661bc8a721261b691b40648c08a` | `plugin/skills/impeccable/reference/audit.native.md` | `fe91fcf28638f95577af481a50edaf339d6c9a3ad3b9fa477bc81c116b8bc392` | derived | 2026-09-07 | https://github.com/pbakaus/impeccable/blob/4db7f6ba4b6ef661bc8a721261b691b40648c08a/plugin/skills/impeccable/reference/audit.native.md |
-| 6 | julianoczkowski/designer-skills @ `c259656c76d9758d7ead46b0d2f125cbe84f8665` | `frontend-design/SKILL.md` | `6a078fa3e5a5cef2656d621a90c8dff8191bd9d8a3724df1b98760262c88ef60` | derived | 2026-09-07 | https://github.com/julianoczkowski/designer-skills/blob/c259656c76d9758d7ead46b0d2f125cbe84f8665/frontend-design/SKILL.md |
+| 1 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/SKILL.md` | `104661e9af51d84dd3e2d620b83d4fb319e69fbaa3d4b10db32e02f85283286b` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/SKILL.md |
+| 2 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/ios.md` | `40c87038b5f75147a5952a96237acf312a327bf70c1bcd8e0a5f064625ae9668` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/ios.md |
+| 3 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/android.md` | `058f81f256134841875fd3183e06b37a023de0c877fd2b9eecd97011640791fe` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/android.md |
+| 4 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/adapt.native.md` | `17c583cf8ad41266ea1e787b666b9d91fe13469d3d0f6af57c08e0146f9b17ac` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/adapt.native.md |
+| 5 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/audit.native.md` | `fe91fcf28638f95577af481a50edaf339d6c9a3ad3b9fa477bc81c116b8bc392` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/audit.native.md |
+| 6 | julianoczkowski/designer-skills @ `c259656c76d9758d7ead46b0d2f125cbe84f8665` | `frontend-design/SKILL.md` | `6a078fa3e5a5cef2656d621a90c8dff8191bd9d8a3724df1b98760262c88ef60` | derived | 2026-10-07 | https://github.com/julianoczkowski/designer-skills/blob/c259656c76d9758d7ead46b0d2f125cbe84f8665/frontend-design/SKILL.md |
+| 7 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/typeset.md` | `da98692848aa2e9ea22c681522a082f2226cb5dbfdb704ac38903be1b4cffafd` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/typeset.md |
+| 8 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/layout.md` | `1d6d2658482b7e2df0c4d27b1b29c5195f0803b402278b96590598f4d3e57aa7` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/layout.md |
+| 9 | pbakaus/impeccable @ `12b25ae25848202ce7a9092442198ada5c4fd984` | `plugin/skills/impeccable/reference/degraded/finish-reviewer.md` | `275dd1b6e63bbd30d2713227c4f79b880a8bc4e01cc48d392068bb86939d3afa` | derived | 2026-10-07 | https://github.com/pbakaus/impeccable/blob/12b25ae25848202ce7a9092442198ada5c4fd984/plugin/skills/impeccable/reference/degraded/finish-reviewer.md |
+| 10 | emilkowalski/skills @ `e8a175de22ae1e49370fc144c1f3bb9aeedf988d` | `skills/emil-design-eng/SKILL.md` | `ffbe68e6007fb42cb8149f089b400a1ca007d59ba23e8948e2be4476f3175939` | adapted | 2026-10-07 | https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/skills/emil-design-eng/SKILL.md |
+| 11 | emilkowalski/skills @ `e8a175de22ae1e49370fc144c1f3bb9aeedf988d` | `skills/review-animations/STANDARDS.md` | `e7d3605034acda54ca13e43aec9e64d65b53de20f75b11b8d694e373012fbe07` | derived | 2026-10-07 | https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/skills/review-animations/STANDARDS.md |
+| 12 | emilkowalski/skills @ `e8a175de22ae1e49370fc144c1f3bb9aeedf988d` | `skills/review-animations/SKILL.md` | `6ff590d29e436766135aa3d137be1fac2a867165c7257fc315b189361f1873af` | derived | 2026-10-07 | https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/skills/review-animations/SKILL.md |
+| 13 | emilkowalski/skills @ `e8a175de22ae1e49370fc144c1f3bb9aeedf988d` | `skills/apple-design/SKILL.md` | `77bb63b7043bb93aca2ff4ab040c249484eef35682bb6ff7163433c31d30adc7` | derived | 2026-10-07 | https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/skills/apple-design/SKILL.md |
+| 14 | emilkowalski/skills @ `e8a175de22ae1e49370fc144c1f3bb9aeedf988d` | `skills/mobile-native/SKILL.md` | `888b7651d66d66dbac4e72b7c554638eb19bd971d686d6cbdf030a5ef3788f55` | derived | 2026-10-07 | https://github.com/emilkowalski/skills/blob/e8a175de22ae1e49370fc144c1f3bb9aeedf988d/skills/mobile-native/SKILL.md |
+| 15 | Leonxlnx/taste-skill @ `e3c92037548e3e49bea8e6b906c99a8549654e71` | `skills/taste-skill/SKILL.md` | `aa194351b246b8b4799099d4ed7b033d29eab6e6e3d58d8d2172978be7b3ec89` | adapted | 2026-10-07 | https://github.com/Leonxlnx/taste-skill/blob/e3c92037548e3e49bea8e6b906c99a8549654e71/skills/taste-skill/SKILL.md |
+| 16 | anthropics/skills @ `2235be7c60b551f5de82ade908fd3816455afcda` | `skills/frontend-design/SKILL.md` | `1608ea77fbb6fc30d13a97d12cfa8ebf31358d40f0dd97beed24829d6b3f45dd` | adapted | 2026-10-07 | https://github.com/anthropics/skills/blob/2235be7c60b551f5de82ade908fd3816455afcda/skills/frontend-design/SKILL.md |
+
+Rows 1–6 were first recorded on 2026-09-07 and re-verified on 2026-10-07: rows
+1–5 moved from impeccable `4db7f6b` to `12b25ae` (only `SKILL.md` changed bytes;
+the four platform references hash the same at both commits), and row 6 hashes
+the same as when it was first read. Rows 7–16 were added on 2026-10-07 for
+material that was already in this pack without a receipt.
+
+### What each row informed
+
+A row without its destination cannot be checked against the text it claims to
+explain, so each one names where it landed.
+
+- **Row 1** — reading a surface by what it is for, and treating an existing
+  visual system as evidence rather than a lock: the brief's Surface and Job
+  lines and the mode table in [`CREATIVE_DIRECTOR.md`](./CREATIVE_DIRECTOR.md)
+  Act 1.
+- **Rows 2–5** — context of use beyond one breakpoint and a native branch that
+  is captured separately: [`MOBILE_SURFACES.md`](./MOBILE_SURFACES.md) (platform
+  target versus prototype renderer, the native state matrix) and the native
+  evidence class in [`VISUAL_REVIEW.md`](./VISUAL_REVIEW.md). Impeccable's own
+  `NOTICE.md` records that `ios.md` and `android.md` are distilled from
+  `ehmo/platform-design-skills` (MIT). Under XD-01 this pack paraphrases the
+  primary platform documentation instead, so no text from either reaches it.
+- **Row 6** — named aesthetic directions used only as prompts for the open axes
+  in [`VISUAL_EXPLORATION.md`](./VISUAL_EXPLORATION.md). **It is not the source
+  of the three default looks** in [`SHELEG_DESIGN.md`](./SHELEG_DESIGN.md): that
+  file has no `F4F1EA`, no terracotta and no broadsheet (checked 2026-10-07
+  against the row's SHA). The paragraph is credited to row 16.
+- **Rows 7–9** — the type, layout and finish-review comparison cited in
+  `CREATIVE_DIRECTOR.md`, which now links the same commit as these rows.
+- **Row 10** — [`MOTION_DOCTRINE.md`](./MOTION_DOCTRINE.md) §1–4: the frequency
+  table and the Raycast example, the purpose list, the easing tree, the three
+  named curves with their comments, the duration rows (reorganised into the
+  `DUR-*` table), the two spring notations and the interruptibility paragraph.
+  Close enough to the source to be `adapted`, so its notice is carried below.
+- **Rows 11–14** — the reconciliation below: the `scale(0)` and `transition: all`
+  bans (rows 11–12), the critically damped default spring (row 13) and the
+  hero-versus-app-shell viewport split (row 14). Restated in this pack's words.
+- **Row 15** — the three calibration dials in [`SKILL.md`](./SKILL.md): names,
+  1–10 poles, the "reading them off the brief" rows and the "do not ask the user
+  to edit a file" rule; and in `MOTION_DOCTRINE.md` "motion claimed is motion
+  shown", one marquee per page, `start: "top top"` for a pin, and continuous
+  input kept out of component state. This pack changed the baseline (`7 / 5 / 4`
+  against the source's `8 / 6 / 4`), added the product-UI, trust-first and deck
+  rows, required observable anchors, and softened the scroll-listener ban to a
+  measured-defect rule. Table rows and sentences remain close, so `adapted`.
+- **Row 16** — "Three looks that are defaults, not decisions" in
+  `SHELEG_DESIGN.md`, adapted from the "For calibration" paragraph at `2235be7`,
+  the version installed when the section was written. At the source's current
+  commit (`41bbe19`, checked 2026-10-07) that paragraph lists five traits; the
+  two new ones are not adopted here.
 
 **Kind.** *derived* — the method was read and re-expressed in this pack's own
 words; no source text was carried over, so no source licence rides on it beyond
 attribution. *adapted* — source text was carried over; a row of that kind
-additionally requires the transfer rules below, and none of the rows above is of
-that kind today.
+additionally requires the transfer rules below. Rows 10, 15 and 16 are of that
+kind, and their notices are in [Third-party notices](#third-party-notices).
 
 ## Transfer rules (apply the moment a row becomes `adapted`)
 
@@ -46,6 +116,109 @@ that kind today.
 3. **A source path, a SHA and a permalink, or it is not adopted.** A method with
    no row here has no provenance and does not ship.
 
+## Reconciliation with the installed motion tools
+
+`emilkowalski/skills` at `e8a175d` is installed beside this skill as a set of
+tools (`MOTION_DOCTRINE.md` §11, `MOBILE_SURFACES.md`, `VISUAL_REVIEW.md`). Its
+doctrine is not copied in further; where its values and this pack's disagreed,
+one value was decided per rule on 2026-10-07, and the doctrine states the reason
+in place. A row reading *agree* was checked and needed no change.
+
+| Rule | This pack before | The tool says | Decided | Why |
+|---|---|---|---|---|
+| RC-01 named curves | `0.23,1,0.32,1` · `0.77,0,0.175,1` · `0.32,0.72,0,1` | the same three (rows 10–11) | agree | one source |
+| RC-02 `ease-in` on an exit | kept for an element leaving the screen entirely | never on UI; exits ride `ease-out` (row 11) | no exit exception | the doctrine's own tree already sent exits to `ease-out` |
+| RC-03 modal and drawer | DUR-SPATIAL 200–300 ms; 500 only as DUR-SHEET-MOBILE | 200–500 ms (rows 10–11) | this pack's rows | the source's 500 contradicts its own under-300 rule |
+| RC-04 UI ceiling | at or under 300 ms | under 300; escalate over 300 without a reason (row 12) | agree, 300 passes | both gates fail 301 |
+| RC-05 default spring | `duration 0.5, bounce 0.2` preferred | `duration 0.5, bounce 0.2` (row 10); critically damped by default, bounce after a flick (row 13) | `duration 0.4, bounce 0` by default; `bounce 0.2` after a flick or drag release | a default with bounce contradicted "keep it out of most UI" |
+| RC-06 `transition: all` | not addressed | first escalation trigger (row 12) | banned in §5 | it animates whatever changes next, layout included |
+| RC-07 `scale(0)` | not addressed | never; start from 0.95, band 0.9–0.97 (rows 10–11) | banned in §5; enter from `scale(0.95)` | nothing real appears from a point |
+| RC-08 reduced motion | collapse to static or instant | fewer and gentler, not zero; keep opacity and colour (rows 11, 13) | movement collapses; an opacity or colour change carrying state may stay | both remove movement; neither licenses a slower slide |
+| RC-09 pure-fade entrance | allowed under reduced motion and where a pack prescribes it | escalation trigger (row 12) | allowed in those two cases | the fade is the reduced-motion answer, not an omission |
+| RC-10 full-height viewport | `svh`, with `dvh` behind `@supports` | `100svh` for a hero, `100dvh` for an app shell (row 14) | the tool's split | `dvh` shifts a hero mid-scroll |
+| RC-11 typeface | the pack names it | system font by default (row 13) | the pack's face | identity is the pack's; `MOTION_DOCTRINE.md` §8 names the swap as drift |
+
+The installed tool files hash identically to the rows above (checked
+2026-10-07 for `emil-design-eng`, `animate`, `animate-expo`, `review-animations`,
+`improve-animations`, `find-animation-opportunities`, `animation-vocabulary`,
+`apple-design`, `mobile-native` and `break-ui`). A newer tool commit reopens this
+table rather than overriding it.
+
+## Third-party notices
+
+Rows 10, 15 and 16 carry source text, so the source's notice travels with it.
+Each adapted passage also names its source where it sits: the opening of
+`MOTION_DOCTRINE.md`, the dials in `SKILL.md`, the closing note of the
+default-looks section in `SHELEG_DESIGN.md`, and the motion section of the
+condensed Cursor rule that ships beside this skill.
+
+### emilkowalski/skills (row 10)
+
+```text
+MIT License
+
+Copyright (c) 2026 Emil Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### Leonxlnx/taste-skill (row 15)
+
+```text
+MIT License
+
+Copyright (c) 2026 Leonxlnx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### anthropics/skills — frontend-design (row 16)
+
+The "three default looks" section of `SHELEG_DESIGN.md` is adapted from
+`skills/frontend-design/SKILL.md` in `anthropics/skills` at commit
+`2235be7c60b551f5de82ade908fd3816455afcda`, licensed under the Apache License,
+Version 2.0. You may obtain a copy of the License at
+<http://www.apache.org/licenses/LICENSE-2.0> or read the copy shipped beside the
+source at
+<https://github.com/anthropics/skills/blob/2235be7c60b551f5de82ade908fd3816455afcda/skills/frontend-design/LICENSE.txt>.
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. The source carries no
+`NOTICE` file. Changes: reworded, restated as a numbered list, and answered with
+this pack's rule that values come from a pack.
+
 ## What is NOT in the knowledge package
 
 The knowledge package is doctrine and method only. It deliberately excludes:

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

@@ -9,6 +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
+- Tools inside this lane — mobile-web fixes and React Native motion
 - Platform target and prototype renderer are two decisions, not one
 - The native state matrix — what each surface owes, and how it is verified
 - Reference sweeps — structure crosses, identity does not
@@ -36,10 +37,15 @@ looking for *mobile* would not think to look, so they are collected here with
 their homes named. Rule 6 is the opposite: nothing in this library answers it,
 and pretending otherwise is worse than the gap.
 
-1. **`100vh` is banned; use `svh`, with `dvh` behind `@supports`.** A bare
-   `100vh` is why a mobile hero jumps when the URL bar hides
+1. **`100vh` is banned; a hero takes `100svh`, an app shell takes `100dvh`.** A
+   bare `100vh` is why a mobile hero jumps when the URL bar hides
    (`styles/field-notes.md`, `styles/cyclorama.md`, and the template's
-   *Responsive* brief).
+   *Responsive* brief). `dvh` resizes as the URL bar collapses, which is right
+   for an app shell or bottom-pinned input and is a layout shift mid-scroll on
+   a hero; `svh` never moves. An earlier wording put `dvh` behind `@supports` on
+   every full-height section, which hands the hero the shift. A viewport unit is
+   platform convention, not identity, so where a pack writes `100dvh` for a
+   full-height marketing section this rule decides it on mobile.
 2. **Inputs are `16px` minimum — a functional floor, not a type choice.**
    Anything smaller triggers zoom-on-focus on iOS. Keep it even where 14px would
    look better (`styles/field-notes.md`, `styles/cyclorama.md`).
@@ -81,6 +87,21 @@ colour and type do not care about the runtime — but no pack's `## Components`
 was written against a tab bar or a sheet, so the component half is yours on any
 native surface, in every pack, whatever its `Contract:` line says about the web.
 
+## Tools inside this lane — mobile-web fixes and React Native motion
+
+Two installed skills (from `emilkowalski/skills`) serve this file as tools,
+called from inside the route and never as a second entry point. Absent, the
+rules here stand alone.
+
+- **`mobile-native`** — the fix list for a **mobile-web** view: the viewport and
+  `theme-color` meta tags, tap highlight, `16px` inputs, hover gated behind
+  `(hover: hover) and (pointer: fine)`, safe-area insets, overscroll. Run it
+  on a mobile-web view, not on a native screen. Its viewport split is rule 1
+  above; on anything identity, the pack wins.
+- **`animate-expo`** — motion on the **React Native / Expo** branch of the
+  table below. The frequency table and the reduced-motion contract in
+  [`MOTION_DOCTRINE.md`](./MOTION_DOCTRINE.md) bind there as on the web.
+
 ## Platform target and prototype renderer are two decisions, not one
 
 Before choosing components, separate **what the surface ships as** from **what

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

@@ -6,6 +6,10 @@ how long it runs, what curve it rides, and which forms are simply wrong.
 
 Every number here is a decision someone else already paid for. Use them.
 
+§1–4 are adapted from `emilkowalski/skills` (`emil-design-eng`, MIT, © 2026 Emil
+Kowalski); the notice, the commit and every value this file decided differently
+are in [`KNOWLEDGE_PROVENANCE.md`](./KNOWLEDGE_PROVENANCE.md).
+
 ---
 
 ## Contents
@@ -20,6 +24,7 @@ Every number here is a decision someone else already paid for. Use them.
 - 8. Anti-drift
 - 9. Reduced motion
 - 10. Pre-flight
+- 11. Tools inside this lane
 - How the calibration dials bind
 
 ## 1. Should this animate at all?
@@ -80,8 +85,9 @@ Is the element entering or leaving?
 It starts slow. The delay lands in the exact moment the user is watching hardest
 — just after the click. A dropdown on `ease-in` at 300 ms *feels* slower than
 the same dropdown on `ease-out` at 300 ms, with identical duration on the clock.
-Keep `ease-in` for something leaving the screen entirely, and even then prefer
-`ease-in-out`.
+**Exits ride `ease-out` too; there is no exit exception.** An earlier wording kept
+`ease-in` for an element leaving the screen entirely, which contradicted the tree
+above and is blocked by `review-animations`.
 
 ### The curves
 
@@ -131,6 +137,11 @@ not a value caught between a permissive row and a strict gate; the old
 `--dur-reveal: 500ms` answers to DUR-ENTRANCE and `--dur-fast: 150ms` to
 DUR-FEEDBACK — both correct; the same 500 ms on a button FAILs DUR-FEEDBACK.
 
+**Where `emil-design-eng` or `review-animations` quotes `200–500ms` for modals and
+drawers, this table wins.** That row contradicts the same source's own under-300
+rule, so the 500 survives here only as DUR-SHEET-MOBILE. The ceilings agree:
+the review tool escalates a UI duration over 300 ms, and 300 itself passes both.
+
 Speed is not only comfort — it is perceived performance. A faster spinner makes
 an identical load feel shorter. A tooltip that skips its delay after the first
 one makes the whole toolbar feel quicker. Easing amplifies this: `ease-out` at
@@ -151,12 +162,17 @@ physical rather than scheduled:
 Prefer Apple's parameterisation — it is the one you can reason about:
 
 ```js
-{ type: "spring", duration: 0.5, bounce: 0.2 }   // preferred
-{ type: "spring", mass: 1, stiffness: 100, damping: 10 }   // when you need the control
+{ type: "spring", duration: 0.4, bounce: 0 }     // default: critically damped, no overshoot
+{ type: "spring", duration: 0.4, bounce: 0.2 }   // only after a flick or a drag release
+{ type: "spring", mass: 1, stiffness: 100, damping: 10 }   // decorative pointer tracking only
 ```
 
-Keep `bounce` between 0.1 and 0.3, and keep it out of most UI. Bounce belongs to
-drag-to-dismiss and to play, not to a settings panel.
+Keep `bounce` between 0.1 and 0.3, and only where the gesture carried momentum.
+Bounce belongs to drag-to-dismiss and to play, not to a settings panel. **The
+default carries no bounce:** an earlier version made `duration 0.5, bounce 0.2`
+the preferred spring, which contradicted the sentence above; `apple-design`
+starts UI critically damped and adds bounce only after a flick, and this file now
+says the same.
 
 **Interruptibility is the real reason to use one.** A spring keeps its velocity
 when interrupted; CSS keyframes restart from zero. Expand a row, hit Escape
@@ -217,6 +233,13 @@ These are not stylistic preferences. Each one is a defect with a known failure.
 - **`will-change` left behind** — it is a hint for motion about to happen, not a
   decoration. Remove it when the animation ends.
 - **More than one marquee per page.** One can carry content; two read as filler.
+- **`transition: all`.** It animates whatever property changes next, layout
+  included, and nobody chose it. Name the properties instead:
+  `transition: transform 200ms var(--ease-out), opacity 200ms var(--ease-out)`.
+- **Entering from `scale(0)`.** Nothing real appears from a point. Enter from
+  `scale(0.95)` with `opacity: 0`; a pack may name another start inside
+  0.9–0.97. A popover scales from its trigger (`transform-origin` at the
+  anchor); a modal stays centred.
 
 ---
 
@@ -289,6 +312,12 @@ Not a feature. A contract.
 - Anything beyond a colour change honours `prefers-reduced-motion: reduce`.
 - Infinite loops, parallax, scroll hijack, magnetic physics and spring chases
   collapse to static or instant — not to "slower".
+- **What may stay is an opacity or colour change that carries a state change**,
+  at DUR-OVERLAY length or shorter. The branch removes movement, not
+  comprehension; `review-animations` and `apple-design` say the same, and neither
+  licenses a slower slide. A pure fade is therefore a correct entrance under the
+  query, and wherever a pack's motion tokens prescribe one, even though the
+  review tool escalates a pure-fade entrance elsewhere.
 - In a motion library, gate on the reduced-motion hook and render the resting
   state. In CSS, put motion behind `@media (prefers-reduced-motion: no-preference)`.
 - WebGL and canvas scenes degrade to their CSS or SVG still.
@@ -350,6 +379,32 @@ Before calling motion done:
 
 ---
 
+## 11. Tools inside this lane
+
+Where `emilkowalski/skills` is installed (Markdown only: no hooks, no scripts),
+its motion skills are **tools this lane calls, never a second entry point.** The
+route still starts at [`SKILL.md`](./SKILL.md), the pack still sets the values,
+and this file still decides whether a thing moves. Absent, nothing here depends
+on them: the sections above are the whole answer.
+
+| Tool | Call it when | What it owes this lane |
+|---|---|---|
+| `review-animations` | reviewing the motion in a diff before it merges; explicit invocation only, it never loads itself | its Block/Approve verdict is read against §3 and the reconciliation in [`KNOWLEDGE_PROVENANCE.md`](./KNOWLEDGE_PROVENANCE.md) |
+| `improve-animations` | auditing a whole codebase's motion; read-only, it writes plans for other agents | each plan item still passes §1 before it is built |
+| `find-animation-opportunities` | asking where something should move and does not; read-only, it proposes values | a proposal on a 100+/day path is rejected by §1, whatever it suggests |
+| `animate` | building one web animation from scratch | durations come from the pack's motion tokens first and §3 second |
+| `animate-expo` | the same in React Native or Expo, the RN branch of [`MOBILE_SURFACES.md`](./MOBILE_SURFACES.md) | the frequency table and §9 bind on a phone exactly as on the web |
+| `apple-design` | springs, gestures, momentum, sheets, translucent materials | the default spring in §4; the pack's face over its system-font default |
+
+**`emil-design-eng` loads on its own.** It has no `disable-model-invocation` and a
+broad description, so on a design task it can arrive beside this skill unasked.
+Its numbers are the ones §1–4 adapted; where it and this file disagree, this file
+wins, and the pack wins over both on values. The differences are decided one rule
+at a time in `KNOWLEDGE_PROVENANCE.md`, so the doctrine and the tool never hand
+an agent two answers.
+
+---
+
 ## How the calibration dials bind
 
 - **The pack wins on values, the dials win on amount.** A dial never invents a

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

@@ -32,6 +32,12 @@ animation, exported" is the mistake this document exists to prevent.
 and stays page motion. Reaching for a rendered file there is a downgrade, and the
 next section prices it.
 
+**The motion tools stop at the same line.** `animate`, `animate-expo`, `apple-design`,
+`review-animations`, `improve-animations` and `find-animation-opportunities` are
+tools for the page rows of the table above, called from inside this route
+(`MOTION_DOCTRINE.md` §11). None of them reads a render timeline, so on the third
+row their verdict is not evidence; the pre-flight at the end of this document is.
+
 ## Before the tool: what a rendered asset costs
 
 A video in a hero looks like a shortcut and is a trade. Four things are given up, and

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

@@ -45,7 +45,6 @@ build new sites on the same principles and understand *why* each piece works.
 - 13. File map (one file per idea)
 - Quick reference — each rule, and the failure it prevents
 - Three looks that are defaults, not decisions
-- Three looks that are defaults, not decisions
 
 ## 0. The one-paragraph thesis
 
@@ -767,12 +766,9 @@ Moved out of `SKILL.md` on 2026-08-16 for the body budget. It sits here because
 it is the same argument this file makes throughout: the values come from a pack
 extracted off a live reference, never from taste at the keyboard.
 
-## Three looks that are defaults, not decisions
-
-Left to itself, generated design lands in one of three places whatever the product
-is — warm cream with a serif and terracotta; near-black with one acid accent;
-broadsheet hairlines at zero radius. Each is legitimate for some brief, and each
-arrives whether or not the brief called for it, which is what makes it a default.
-**If a pack's field sits near one of these, that is a measurement; if a page arrives
-at one without a pack, that is the default talking** — say which out loud before
-shipping. The three documents, in full: [`SHELEG_DESIGN.md`](./SHELEG_DESIGN.md).
+*Adapted from the "For calibration" paragraph of `anthropics/skills`
+`frontend-design` (Apache-2.0, commit `2235be7`). Changed here: the three looks
+are restated as a numbered list and answered with this library's rule — values
+come from a pack — rather than the source's advice on spending a free axis. The
+licence notice and the row are in
+[`KNOWLEDGE_PROVENANCE.md`](./KNOWLEDGE_PROVENANCE.md).*

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

@@ -4,7 +4,7 @@ description: Use when deciding how something LOOKS or MOVES — cinematic landin
 license: MIT
 compatibility: Kit/lane commands need node>=16, npx, network. Optional siblings — dataviz, shadcn, migrate-radix-to-base. Each has an in-text fallback when absent or unreachable.
 metadata:
-  version: 1.61.2
+  version: 1.61.3
 ---
 
 # SHELEG Design
@@ -131,7 +131,8 @@ observable anchors — a bare number cannot do that, so **a number without its
 anchors is not evidence**.
 
 **Three dials carry the same intent as optional shorthand** — preference
-hints, not measurements of quality:
+hints, not measurements of quality (from `Leonxlnx/taste-skill`, MIT,
+[notice](./KNOWLEDGE_PROVENANCE.md)):
 
 - **`DESIGN_VARIANCE`** 1–10 — 1 is perfect symmetry, 10 is deliberate
   asymmetry and no two sections alike.
@@ -265,7 +266,6 @@ silent fallbacks compares the fallbacks. No CSS-swap promise follows:
 components keep consuming the pack's own tokens.
 
 **What a comparison records — one component, one content, one viewport at a
-time, through the adapters.** **What a comparison records — one component, one content, one viewport at a
 time, through the adapters.** A difference is attributable to the pack only
 when everything else is pinned: the receipt per candidate names the pack, its
 adapter status, the compared component's geometry (positions and sizes as

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

@@ -11,6 +11,7 @@ rather than dressed up as a reading.
 
 - The capture record
 - Fitness — what disqualifies a frame
+- Worst-case data before the capture
 - Capture is tool-agnostic
 - Visual evidence is its own class — do not launder others into it
 - Rendered copy — the design/copywriting seam
@@ -52,6 +53,19 @@ available**, the claim is recorded as **`unverified`**, not as a pass. Static
 work continues — the contract never demands a mandatory tool install — it is
 just honest that the visual half was not seen.
 
+## Worst-case data before the capture
+
+A populated frame of the happy path proves the happy path. Before capturing a
+`populated` state, put the component through its worst data: long names,
+unbreakable emails, one-letter names, missing fields, huge counts, zero items,
+non-Latin text, emoji. Where **`break-ui`** is installed (from
+`emilkowalski/skills`), it is the tool for this inside the sheleg-design route,
+never a second entry point: it renders the component behind a demo-versus-worst
+toggle and reports what broke, what it left for you to decide, and what held.
+Absent, list the worst cases by hand. Either way the capture record's `state`
+names which data the frame shows, and a demo-data frame never answers a claim
+about overflow, truncation or wrapping.
+
 ## Capture is tool-agnostic
 
 The capability that produces the frame is named in `source`, and **any working