diff --git a/.changes/testing/docs-upstream-emilkowalski-skills-reaudit-895c960c.md b/.changes/testing/docs-upstream-emilkowalski-skills-reaudit-895c960c.md new file mode 100644 index 00000000000..3e13fa7fdf1 --- /dev/null +++ b/.changes/testing/docs-upstream-emilkowalski-skills-reaudit-895c960c.md @@ -0,0 +1,7 @@ +--- +bump: patch +--- + +### Fixed + +- The `worst-case` initials fix skips a generational suffix, so `Christopher Alexander Montgomery III` no longer still yields `CI`, and a field with no limit is reported as "no limit found", which says what the search showed. diff --git a/.changes/user-interface/docs-upstream-emilkowalski-skills-reaudit-72270621.md b/.changes/user-interface/docs-upstream-emilkowalski-skills-reaudit-72270621.md new file mode 100644 index 00000000000..98a827eca68 --- /dev/null +++ b/.changes/user-interface/docs-upstream-emilkowalski-skills-reaudit-72270621.md @@ -0,0 +1,9 @@ +--- +bump: patch +--- + +### Fixed + +- The theming reference no longer says the iOS status-bar style tag shares the manifest's theme color decision: that tag takes a style keyword, not a color, per Apple's meta tag reference. +- The choreography rules no longer describe a guard that holds input until a buildup finishes, which contradicted the rule that motion never blocks input. +- The glossary's perceptual duration entry reads as a definition. diff --git a/docs/upstream/emilkowalski-skills.md b/docs/upstream/emilkowalski-skills.md index dadbc00bcb5..8b11f2d24a7 100644 --- a/docs/upstream/emilkowalski-skills.md +++ b/docs/upstream/emilkowalski-skills.md @@ -5,7 +5,7 @@ Single source of truth for everything in this marketplace derived from UI craft: animation, interface review, worst-case content, touch polish and prototyping. Provenance lives here and in plugin changelog fragments, never in skill files, where it is agent-facing noise. -**Last audited upstream state:** `emilkowalski/skills@5206a950b715e0cabe7043ea0b2304332b91494e` under `skills/` (committed 2026-11-08T12:15:47Z; no tags or releases). +**Last audited upstream state:** `emilkowalski/skills@64eb3deb9a5fbfa041faf783e0bc3fd635872e9c` under `skills/` (committed 2026-11-15T12:42:50Z; no tags or releases). Upstream's skills install through `npx skills add`; this marketplace takes none of that path and ships the content as its own plugin skills and references. @@ -31,7 +31,7 @@ reauthored derivative: [`user-interface`](../../plugins/user-interface/LICENSE), [`testing`](../../plugins/testing/LICENSE), [`prototype`](../../plugins/prototype/LICENSE). - **Pointer**: when re-auditing a row, fetch the compare view of upstream against the pin live: - . + . - **As of**: the 40-hex pin above stands in for the as-of date. The commit fixes exactly what was read, and this page's git history records when. - **Recheck trigger**: a change, between the pinned commit and upstream HEAD, to a path a row we @@ -51,32 +51,33 @@ Each upstream link is at the pin. | Upstream path | Ours | Relation | Taken / rejected | |---|---|---|---| -| [`LICENSE`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/LICENSE) | Per-plugin `LICENSE` files (above) | Notice | **Taken:** the MIT notice. | -| [`README.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/README.md) | This record | Omitted | **Taken:** the skill list (now including `choreograph` and `gestures`) and license facts. **Rejected:** the `npx skills add` install line, which would update outside the marketplace, and the newsletter links. | -| [`performance-cheatsheet.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/performance-cheatsheet.md) | `user-interface` `reference/animation/performance.md` | Absorbed | **Taken:** the property-cost and `will-change`-last rows, merged into the performance reference. **Rejected:** library-specific rows as rules (kept only as stack lookups at run time). | -| [`ui-cheatsheet.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/ui-cheatsheet.md) | `user-interface` `reference/types/web/generic-defaults.md` section 10, `reference/types/web/layout-stability.md` section 7 | Partial | **Taken:** absolute dates after a week, `Intl.PluralRules`, `flex-shrink: 0` on an avatar. **Already covered:** the other eight rows. | -| [`skills/choreograph/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/choreograph/SKILL.md) | `user-interface` `reference/animation/catalog.md` `choreography`, `behaviors.md` `view-swap`; a step-6 pointer in `/user-interface:write-animation` | Absorbed (skill omitted) | **Taken:** a role for each moving element, a single entrance for a container, the per-pair relationship (together by default, then overlap, sequence or carry), stagger ordered by importance with treatment varied by role, one timing family per component, secondary motion hooked to the lead, timing scaled to how much changed, direction and all-at-once group exits, interruption of a multi-part sequence, idle attention loops, reduced motion that collapses the group, and the timeline written before code. It replaces the catalog's earlier line that sequenced clashing elements by default. **Already covered:** high-frequency surfaces skip stagger and stagger never blocks input (`should-it-animate`, `stagger`), larger marketing offsets (`section-entrance`), exits shorter than entrances (`duration`, `exit`), leaving elements releasing their slot (`group-exit`), untrusted repository content. **Rejected:** the stagger interval and total figures (the `animation.stagger_ms` config and `aiforui-course.md` govern), the attention-loop and resize-clamp numbers (no config key earns them yet), library calls as guidance (run-time lookups), and a standalone skill. | -| [`skills/choreograph/RECIPES.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/choreograph/RECIPES.md) | `user-interface` `behaviors.md` `group-exit` and `view-swap` | Partial | **Taken:** the library-free slot release for a leaving element, the resize-scaled content fade, direction reaching a leaving view, the small-container crossfade, the duplicate-view option for a dense morph, and the stable-key check. **Already covered:** the index-variable CSS stagger and its fill mode (`section-entrance`). **Rejected:** every code block as shipped code, and per-library APIs as rules, each a run-time lookup. | -| [`skills/gestures/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/gestures/SKILL.md) | `user-interface` `reference/animation/gestures.md` `direct-manipulation` and `linked-progress`, `behaviors.md` `drag-to-dismiss`, `catalog.md` `reduced-motion`; config key `animation.gesture.distance_threshold` | Absorbed (skill omitted) | **Taken:** no spring or transition while tracking, one progress value driving linked visuals, a fast spring-back, and pointer tracking kept under reduced motion with momentum and bounce dropped. `animation.gesture.distance_threshold` defaults to `0.4`, the low end of his 40-50% of travel; no measured fact or accessibility floor changed it. **Already covered:** the velocity-seeded release spring (`velocity-handoff`), dismissal on a flick (`animation.gesture.velocity_threshold`), edge resistance (`rubber-banding`), catching a motion mid-flight (`interruptible`), writing the moving value on the element (`drag-details`), linear hold timing (`hold-to-confirm`), and the touch checklist (`reference/types/touch-web.md`). **Deferred:** dismissing in the direction an element entered. **Rejected:** the 500ms sheet duration and the position settle under reduced motion (`aiforui-course.md` wins any conflict with this upstream, and the catalog's floor removes movement), library drag props and thresholds as guidance (run-time lookups), and a standalone skill. | -| [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/emil-design-eng/SKILL.md) | `user-interface` `reference/animation/` (catalog, behaviors, gestures) | Absorbed (skill omitted) | **Taken:** the animation decision framework, springs and interruptibility, transform origin, stagger, gesture handling and the debugging checklist. **Rejected:** the non-motion design rules the `design` skill already covers; framework-specific code as guidance. **Superseded in part:** the catalog's easing, exit, duration, stagger and reduced-motion wording follows `docs/upstream/aiforui-course.md`. | -| [`skills/animate/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/animate/SKILL.md) | [`/user-interface:write-animation`](../../plugins/user-interface/skills/write-animation/SKILL.md) | Derived | **Taken:** the build sequence (decide whether to animate, then purpose, properties, curve, duration, origin, reduced motion), the hard rules and the feel check. **Changed:** project tokens first, stack detection and run-time lookup, CSS authoring delegated to `/user-interface:write-css`. | -| [`skills/animate/RECIPES.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/animate/RECIPES.md) | `user-interface` `reference/animation/behaviors.md` | Derived | **Taken:** each recipe's behavior (what moves, properties, curve, duration, origin, interruptibility, reduced-motion fallback) as a stack-neutral spec. **Rejected:** the CSS and JS blocks as shipped code; library-specific attributes. **Superseded in part:** component recipes added and re-timed per `docs/upstream/aiforui-course.md`. | -| [`skills/animation-vocabulary/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/animation-vocabulary/SKILL.md) | [`/user-interface:glossary`](../../plugins/user-interface/skills/glossary/SKILL.md) | Absorbed | **Taken:** the terms by category and the reverse lookup from the effect someone wants to its name. | -| [`skills/animation-performance/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/animation-performance/SKILL.md) | `user-interface` `reference/animation/performance.md`; the `performance` sub-mode of the motion lane of [`/user-interface:audit`](../../plugins/user-interface/skills/audit/SKILL.md) | Absorbed (skill omitted) | **Taken:** the frame budget, property cost tiers, cheaper-property swaps, main-thread versus off-thread drivers, the per-frame re-render and inherited-variable traps, `will-change` last, the ordered cause list and the "verified from code / needs a device recording" labels. **Rejected:** library and product anecdotes as rules; browser-support lists, replaced by dated pointers. **Superseded in part:** the `transition: all`, blur, `will-change` and library-shorthand text follows `docs/upstream/aiforui-course.md`. | -| [`skills/apple-design/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/apple-design/SKILL.md) | `user-interface` `reference/animation/gestures.md` | Partial | **Taken:** fluid-interface principles, momentum projection and rubber-banding math, velocity handed to the spring. **Deferred:** materials and typography notes. | -| [`skills/break-ui/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/break-ui/SKILL.md) | The `worst-case` action of [`/testing:run-e2e`](../../plugins/testing/skills/run-e2e/SKILL.md) | Derived, re-posture | **Taken:** mapping every rendered value, the worst-case fixture shaped like the demo data, the environments, the failure-signature table, the truncate-wrap-clamp rule and the three-part report. **Changed:** report-first, injection at the network layer where possible, a backup and a proven revert, the fixture kept only on request. **Rejected:** a standalone skill. | -| [`skills/break-ui/CATALOG.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/break-ui/CATALOG.md) | `testing` `skills/run-e2e/context/worst-case.md` | Derived | **Taken:** the worst-case values for people, states and environment, extendable by a consumer file. | -| [`skills/find-animation-opportunities/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/find-animation-opportunities/SKILL.md) | The `opportunities` sub-mode of the motion lane of `/user-interface:audit` | Absorbed (skill omitted) | **Taken:** the search for places motion helps and the list of what not to animate. | -| [`skills/improve-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/improve-animations/SKILL.md) | The `tree` scope of `/user-interface:audit` | Partial | **Taken:** the codebase-wide audit and prioritization. **Rejected:** plan files written into the consumer's repository root; implementation hands off to `/implementation:implement` when installed. | -| [`skills/improve-animations/AUDIT.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/improve-animations/AUDIT.md) | `user-interface` `reference/animation/catalog.md` | Absorbed | **Taken:** the audit categories as the catalog's sections. | -| [`skills/improve-animations/PLAN-TEMPLATE.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/improve-animations/PLAN-TEMPLATE.md) | `user-interface` `reference/animation/catalog.md` | Partial | **Taken:** the feel-check block. **Rejected:** the plan file shape. | -| [`skills/remove-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/remove-animations/SKILL.md) | The `removal` sub-mode of the motion lane of `/user-interface:audit` | Absorbed (skill omitted) | **Taken:** the reversed burden of proof, delete, reduce and keep verdicts, the required kept list, the removal hazards and the cleanup. **Changed:** the gate is the catalog's `should-it-animate`, and reductions use the resolved config's roles rather than fixed numbers; read-only unless `--fix`. **Rejected:** a standalone skill; library-specific sweep terms as rules. | -| [`skills/review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/review-animations/SKILL.md) | The default (diff) scope of `/user-interface:audit` | Derived, re-posture | **Taken:** the review standards and escalation triggers as catalog-backed checks. **Changed:** read-only by default; an explicit `--fix` applies one finding at a time. | -| [`skills/review-animations/STANDARDS.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/review-animations/STANDARDS.md) | `user-interface` `reference/animation/catalog.md` | Absorbed | **Taken:** the standards, de-duplicated with `AUDIT.md`, with the corpus's internal contradictions resolved. **Superseded in part:** the catalog's graded findings and its ease-in row follow `docs/upstream/aiforui-course.md`. | -| [`skills/mobile-native/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/mobile-native/SKILL.md) | `user-interface` `reference/types/touch-web.md` | Derived, re-posture | **Taken:** capability-based touch rules: hover gated by pointer capability, tap highlight, safe areas, dynamic viewport units, no zoom lock, target sizes. **Rejected:** framework-specific setup. **Superseded in part:** the course record [`aiforui-course.md`](aiforui-course.md) (S29, S37) now shapes this file, with course wording verbatim and Tailwind and Next.js notes as dated pointers. | -| [`skills/pick-ui-library/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/pick-ui-library/SKILL.md) | `user-interface` `reference/component-libraries.md` | Partial | **Taken:** identify the task rather than the library named; prefer a library already installed; selection criteria. **Rejected:** the library list as guidance (one framework, quickly stale); a React primitives table with pointer records and a `components.primitives_default` setting stand in its place. | -| [`skills/prototype/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/prototype/SKILL.md) | [`/prototype:explore-directions`](../../plugins/prototype/skills/explore-directions/SKILL.md) and `prototype` `context/discipline.md` | Absorbed (skill omitted) | **Taken:** variants differ on a named axis, the tradeoff table, never pre-pick a winner, cut a converged variant. | -| [`skills/prototype/PICKER.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/prototype/PICKER.md) | `prototype` `skills/explore-directions/assets/variant-switcher.html` | Derived | **Taken:** the floating switcher's controls and behavior. **Rejected:** URL persistence, which a `file://` page cannot rely on. | +| [`LICENSE`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/LICENSE) | Per-plugin `LICENSE` files (above) | Notice | **Taken:** the MIT notice. | +| [`README.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/README.md) | This record | Omitted | **Taken:** the skill list (now including `choreograph`, `gestures`, `learn-taste` and `ask-emil`; `write-swift` is off the list but still in the tree) and license facts. **Rejected:** the `npx skills add` install line, which would update outside the marketplace, and the newsletter and per-skill site links. | +| [`performance-cheatsheet.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/performance-cheatsheet.md) | `user-interface` `reference/animation/performance.md` | Absorbed | **Taken:** the property-cost and `will-change`-last rows, merged into the performance reference. **Rejected:** library-specific rows as rules (kept only as stack lookups at run time). | +| [`ui-cheatsheet.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/ui-cheatsheet.md) | `user-interface` `reference/types/web/generic-defaults.md` section 10, `reference/types/web/layout-stability.md` section 7 | Partial | **Taken:** absolute dates after a week, `Intl.PluralRules`, `flex-shrink: 0` on an avatar. **Already covered:** the other eight rows. | +| [`skills/choreograph/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/choreograph/SKILL.md) | `user-interface` `reference/animation/catalog.md` `choreography`, `behaviors.md` `view-swap`; a step-6 pointer in `/user-interface:write-animation` | Absorbed (skill omitted) | **Taken:** a role for each moving element, a single entrance for a container, the per-pair relationship (together by default, then overlap, sequence or carry), stagger ordered by importance with treatment varied by role, one timing family per component, secondary motion hooked to the lead, timing scaled to how much changed, direction and all-at-once group exits, interruption of a multi-part sequence, idle attention loops, reduced motion that collapses the group, and the timeline written before code. It replaces the catalog's earlier line that sequenced clashing elements by default. **Already covered:** high-frequency surfaces skip stagger and stagger never blocks input (`should-it-animate`, `stagger`), larger marketing offsets (`section-entrance`), exits shorter than entrances (`duration`, `exit`), leaving elements releasing their slot (`group-exit`), untrusted repository content. **Rejected:** the stagger interval and total figures (the `animation.stagger_ms` config and `aiforui-course.md` govern), the attention-loop and resize-clamp numbers (no config key earns them yet), library calls as guidance (run-time lookups), a flag that ignores clicks until the buildup ends (dropped upstream, and `stagger` keeps input open during motion), and a standalone skill. | +| [`skills/choreograph/RECIPES.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/choreograph/RECIPES.md) | `user-interface` `behaviors.md` `group-exit` and `view-swap` | Partial | **Taken:** the library-free slot release for a leaving element, the resize-scaled content fade, direction reaching a leaving view, the small-container crossfade, the duplicate-view option for a dense morph, and the stable-key check. **Already covered:** a CSS stagger whose fill mode holds the start state (`section-entrance`). **Rejected:** every code block as shipped code, including the hand-set delay per element in the CSS stagger (`section-entrance` multiplies an index by `animation.stagger_ms.section`, and shrinking gaps are the catalog's `choreography`), and per-library APIs as rules, each a run-time lookup. | +| [`skills/gestures/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/gestures/SKILL.md) | `user-interface` `reference/animation/gestures.md` `direct-manipulation` and `linked-progress`, `behaviors.md` `drag-to-dismiss`, `catalog.md` `reduced-motion`; config key `animation.gesture.distance_threshold` | Absorbed (skill omitted) | **Taken:** no spring or transition while tracking, one progress value driving linked visuals, a fast spring-back, and pointer tracking kept under reduced motion with momentum and bounce dropped. `animation.gesture.distance_threshold` defaults to `0.4`, the low end of his 40-50% of travel; no measured fact or accessibility floor changed it. **Already covered:** the velocity-seeded release spring (`velocity-handoff`), dismissal on a flick (`animation.gesture.velocity_threshold`), edge resistance (`rubber-banding`), catching a motion mid-flight (`interruptible`), writing the moving value on the element (`drag-details`), linear hold timing (`hold-to-confirm`), a ceiling on release bounce (`animation.spring.bounce.playful_max`), and the touch checklist (`reference/types/touch-web.md`). **Deferred:** dismissing in the direction an element entered. **Rejected:** the 500ms sheet duration and the position settle under reduced motion (`aiforui-course.md` wins any conflict with this upstream, and the catalog's floor removes movement), library drag props, selectors and thresholds as guidance, and the release a CSS-only library runs itself (run-time lookups), and a standalone skill. | +| [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/emil-design-eng/SKILL.md) | `user-interface` `reference/animation/` (catalog, behaviors, gestures) | Absorbed (skill omitted) | **Taken:** the animation decision framework, springs and interruptibility, transform origin, stagger, gesture handling and the debugging checklist. **Rejected:** the non-motion design rules the `design` skill already covers; framework-specific code as guidance. **Superseded in part:** the catalog's easing, exit, duration, stagger and reduced-motion wording follows `docs/upstream/aiforui-course.md`. | +| [`skills/animate/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/animate/SKILL.md) | [`/user-interface:write-animation`](../../plugins/user-interface/skills/write-animation/SKILL.md) | Derived | **Taken:** the build sequence (decide whether to animate, then purpose, properties, curve, duration, origin, reduced motion), the hard rules and the feel check. **Changed:** project tokens first, stack detection and run-time lookup, CSS authoring delegated to `/user-interface:write-css`. | +| [`skills/animate/RECIPES.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/animate/RECIPES.md) | `user-interface` `reference/animation/behaviors.md` | Derived | **Taken:** each recipe's behavior (what moves, properties, curve, duration, origin, interruptibility, reduced-motion fallback) as a stack-neutral spec. **Rejected:** the CSS and JS blocks as shipped code; library-specific attributes. **Superseded in part:** component recipes added and re-timed per `docs/upstream/aiforui-course.md`. | +| [`skills/animation-vocabulary/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/animation-vocabulary/SKILL.md) | [`/user-interface:glossary`](../../plugins/user-interface/skills/glossary/SKILL.md) | Absorbed | **Taken:** the terms by category and the reverse lookup from the effect someone wants to its name. | +| [`skills/animation-performance/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/animation-performance/SKILL.md) | `user-interface` `reference/animation/performance.md`; the `performance` sub-mode of the motion lane of [`/user-interface:audit`](../../plugins/user-interface/skills/audit/SKILL.md) | Absorbed (skill omitted) | **Taken:** the frame budget, property cost tiers, cheaper-property swaps, main-thread versus off-thread drivers, the per-frame re-render and inherited-variable traps, `will-change` last, the ordered cause list and the "verified from code / needs a device recording" labels. **Already covered:** a closed panel at zero opacity also set to `visibility: hidden` (`reference/types/web/accessibility.md` section 5). **Rejected:** library and product anecdotes as rules; browser-support lists, replaced by dated pointers. **Superseded in part:** the `transition: all`, blur, `will-change` and library-shorthand text follows `docs/upstream/aiforui-course.md`. | +| [`skills/apple-design/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/apple-design/SKILL.md) | `user-interface` `reference/animation/gestures.md` | Partial | **Taken:** fluid-interface principles, momentum projection and rubber-banding math, velocity handed to the spring. **Deferred:** materials and typography notes. | +| [`skills/break-ui/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/break-ui/SKILL.md) | The `worst-case` action of [`/testing:run-e2e`](../../plugins/testing/skills/run-e2e/SKILL.md) | Derived, re-posture | **Taken:** mapping every rendered value, the worst-case fixture shaped like the demo data, the environments, the failure-signature table, the truncate-wrap-clamp rule and the three-part report, initials that skip a generational suffix, and a missing limit reported as "no limit found". **Changed:** report-first, injection at the network layer where possible, a backup and a proven revert, the fixture kept only on request. **Rejected:** fix-by-number replies and the in-page toggle's checks (the action fixes nothing and mounts no toggle), vendor-prefixed clamp properties (a run-time lookup), and a standalone skill. | +| [`skills/break-ui/CATALOG.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/break-ui/CATALOG.md) | `testing` `skills/run-e2e/context/worst-case.md` | Derived | **Taken:** the worst-case values for people, states and environment, extendable by a consumer file. | +| [`skills/find-animation-opportunities/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/find-animation-opportunities/SKILL.md) | The `opportunities` sub-mode of the motion lane of `/user-interface:audit` | Absorbed (skill omitted) | **Taken:** the search for places motion helps and the list of what not to animate. | +| [`skills/improve-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/improve-animations/SKILL.md) | The `tree` scope of `/user-interface:audit` | Partial | **Taken:** the codebase-wide audit and prioritization. **Rejected:** plan files written into the consumer's repository root; implementation hands off to `/implementation:implement` when installed. | +| [`skills/improve-animations/AUDIT.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/improve-animations/AUDIT.md) | `user-interface` `reference/animation/catalog.md` | Absorbed | **Taken:** the audit categories as the catalog's sections. | +| [`skills/improve-animations/PLAN-TEMPLATE.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/improve-animations/PLAN-TEMPLATE.md) | `user-interface` `reference/animation/catalog.md` | Partial | **Taken:** the feel-check block. **Rejected:** the plan file shape. | +| [`skills/remove-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/remove-animations/SKILL.md) | The `removal` sub-mode of the motion lane of `/user-interface:audit` | Absorbed (skill omitted) | **Taken:** the reversed burden of proof, delete, reduce and keep verdicts, the required kept list, the removal hazards and the cleanup. **Changed:** the gate is the catalog's `should-it-animate`, and reductions use the resolved config's roles rather than fixed numbers; read-only unless `--fix`. **Rejected:** a standalone skill; library-specific sweep terms as rules. | +| [`skills/review-animations/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/review-animations/SKILL.md) | The default (diff) scope of `/user-interface:audit` | Derived, re-posture | **Taken:** the review standards and escalation triggers as catalog-backed checks. **Changed:** read-only by default; an explicit `--fix` applies one finding at a time. | +| [`skills/review-animations/STANDARDS.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/review-animations/STANDARDS.md) | `user-interface` `reference/animation/catalog.md` | Absorbed | **Taken:** the standards, de-duplicated with `AUDIT.md`, with the corpus's internal contradictions resolved. **Superseded in part:** the catalog's graded findings and its ease-in row follow `docs/upstream/aiforui-course.md`. | +| [`skills/mobile-native/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/mobile-native/SKILL.md) | `user-interface` `reference/types/touch-web.md` | Derived, re-posture | **Taken:** capability-based touch rules: hover gated by pointer capability, tap highlight, safe areas, dynamic viewport units, no zoom lock, target sizes, and the iOS status-bar tag taking a style keyword rather than a color (`reference/types/web/theming.md`). **Rejected:** framework-specific setup. **Superseded in part:** the course record [`aiforui-course.md`](aiforui-course.md) (S29, S37) now shapes this file, with course wording verbatim and Tailwind and Next.js notes as dated pointers. | +| [`skills/pick-ui-library/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/pick-ui-library/SKILL.md) | `user-interface` `reference/component-libraries.md` | Partial | **Taken:** identify the task rather than the library named; prefer a library already installed; selection criteria. **Rejected:** the library list as guidance (one framework, quickly stale); a React primitives table with pointer records and a `components.primitives_default` setting stand in its place. | +| [`skills/prototype/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/prototype/SKILL.md) | [`/prototype:explore-directions`](../../plugins/prototype/skills/explore-directions/SKILL.md) and `prototype` `context/discipline.md` | Absorbed (skill omitted) | **Taken:** variants differ on a named axis, the tradeoff table, never pre-pick a winner, cut a converged variant. | +| [`skills/prototype/PICKER.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/prototype/PICKER.md) | `prototype` `skills/explore-directions/assets/variant-switcher.html` | Derived | **Taken:** the floating switcher's controls and behavior. **Rejected:** URL persistence, which a `file://` page cannot rely on. | +| [`skills/learn-taste/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/learn-taste/SKILL.md) | None yet | Adapt, not applied | **Adapt, owner's decision ([#16532](https://github.com/melodic-software/claude-code-plugins/issues/16532)):** sweeping a session for design corrections nobody named (an edit to a file the agent wrote, a run of nudges, a variant picked or reverted) and writing each, with its reason, as a project design rule. **Already covered:** counting a described mistake and proving a check for it (`/corrections:codify`), and reading a root `DESIGN.md` as a project design signal (`user-interface` `scripts/detect.mjs`). | ## Config keys @@ -86,9 +87,9 @@ keys with their rows; the values live only in `defaults.yaml`. | Key | Upstream path | |---|---| -| `animation.scale.press`, `animation.scale.press_min` (the limit `/user-interface:audit` reports a project press scale below; owner decision, 2026-11-09), `animation.gesture.velocity_threshold` | [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/emil-design-eng/SKILL.md) | -| `animation.gesture.deceleration_rate`, `animation.gesture.rubberband_constant`, `animation.gesture.slop_px`, `animation.spring.response_s` | [`skills/apple-design/SKILL.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/apple-design/SKILL.md) | -| `animation.inspect_playback_rate` | [`skills/improve-animations/PLAN-TEMPLATE.md`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/skills/improve-animations/PLAN-TEMPLATE.md) | +| `animation.scale.press`, `animation.scale.press_min` (the limit `/user-interface:audit` reports a project press scale below; owner decision, 2026-11-09), `animation.gesture.velocity_threshold` | [`skills/emil-design-eng/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/emil-design-eng/SKILL.md) | +| `animation.gesture.deceleration_rate`, `animation.gesture.rubberband_constant`, `animation.gesture.slop_px`, `animation.spring.response_s` | [`skills/apple-design/SKILL.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/apple-design/SKILL.md) | +| `animation.inspect_playback_rate` | [`skills/improve-animations/PLAN-TEMPLATE.md`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/improve-animations/PLAN-TEMPLATE.md) | ## Post sources @@ -109,16 +110,19 @@ check does not watch these rows. Units we took nothing from; each counts only if removed upstream. -- [`.gitattributes`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/.gitattributes) - and [`.gitignore`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/.gitignore): +- [`.gitattributes`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/.gitattributes) + and [`.gitignore`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/.gitignore): repository plumbing. -- [`.pl`](https://github.com/emilkowalski/skills/blob/5206a950b715e0cabe7043ea0b2304332b91494e/.pl): +- [`.pl`](https://github.com/emilkowalski/skills/blob/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/.pl): an empty stray file. -- [`skills/ask-sonner`](https://github.com/emilkowalski/skills/tree/5206a950b715e0cabe7043ea0b2304332b91494e/skills/ask-sonner): +- [`skills/ask-sonner`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/ask-sonner): one library's API and prop tables, the most volatile content in the corpus and the kind of specific a skill looks up at run time. -- [`skills/animate-expo`](https://github.com/emilkowalski/skills/tree/5206a950b715e0cabe7043ea0b2304332b91494e/skills/animate-expo): +- [`skills/animate-expo`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/animate-expo): the platform vendor's own plugin covers it, so `user-interface` `reference/routing.json` routes to `expo@expo-plugins`; its shared gesture math is taken from `apple-design` instead. -- [`skills/write-swift`](https://github.com/emilkowalski/skills/tree/5206a950b715e0cabe7043ea0b2304332b91494e/skills/write-swift): +- [`skills/write-swift`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/write-swift): one language, no interface surface in this marketplace. +- [`skills/ask-emil`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c/skills/ask-emil): + a picker over upstream's own skill names; `/session-flow:recommend-skills` ranks the skills + installed here, and `user-interface` `reference/routing.json` routes each concern. diff --git a/plugins/testing/skills/run-e2e/context/worst-case.md b/plugins/testing/skills/run-e2e/context/worst-case.md index 7634cae1a28..030d992f108 100644 --- a/plugins/testing/skills/run-e2e/context/worst-case.md +++ b/plugins/testing/skills/run-e2e/context/worst-case.md @@ -17,8 +17,8 @@ the dirty-file refusal, the revert proof or `--keep`; report it under What broke 1. **Plausible or schema-backed, never random.** Each value is something a real user could produce, or the actual limit from the validation schema, database column or API contract. A field with - no limit anywhere is a finding: say "unbounded" and test something long but believable. Never - use strings of one repeated character. + no limit anywhere is a finding: say "no limit found" and test something long but believable. + Never use strings of one repeated character. 2. **Change the data, not the component.** The worst case enters through the same boundary the demo data does. Never edit markup or styles to produce a break. 3. **One dataset, many failures.** Spread different failures across the first rows on screen, as @@ -60,7 +60,7 @@ List every value the target renders with its source, type, limit and whether it | Field | Source | Type | Limit | Optional | |---|---|---|---|---| | `name` | `member.name` | string | 255 (`schema:14`) | no | -| `count` | `workspace.memberCount` | integer | unbounded | no | +| `count` | `workspace.memberCount` | integer | no limit found | no | Include the values people forget: counts in headings, relative times, badge and status text, labels that come from data, tooltips, images, and the list itself (its length is a value). Read @@ -200,7 +200,7 @@ equivalents instead of applying these fixes. | An avatar adrift beside a three-line name | rows of varying height centered | top-align once text can wrap | | The last row cut mid-glyph | a fixed-height box with no scroll affordance | a visible scrollbar or a fade, and intended overflow | | A heading breaks mid-word | break-all word breaking | break only when needed | -| Wrong initials | splitting on the first space and taking a code unit | initials from grapheme clusters, first and last word, a fallback icon | +| Wrong initials | splitting on the first space and taking a code unit | initials from grapheme clusters, first and last word with a generational suffix (Jr, III) skipped, a fallback icon | | An orphaned dash where an optional field was | a placeholder for a missing value | omit the line or reserve its height on purpose | | "1 members" | a hardcoded plural | locale plural rules or separate strings | | Numbers jitter as they update | proportional figures | tabular figures | diff --git a/plugins/user-interface/reference/animation/catalog.md b/plugins/user-interface/reference/animation/catalog.md index 57d3fb3cb45..91849a67ded 100644 --- a/plugins/user-interface/reference/animation/catalog.md +++ b/plugins/user-interface/reference/animation/catalog.md @@ -432,8 +432,8 @@ moving parts, then run what is left in parallel unless the order means something once, with no reverse stagger, along the path it entered by (`exit` in behaviors.md). 9. **Interruption.** A re-trigger mid-sequence stops every animation still running before starting the next; never stack them. Anything that resumes afterwards (an idle loop) waits until every - reset animation has finished. A guard that only gates input (the buildup has finished) is not - rendered state. Rapid switching must never leave two views mounted. + reset animation has finished. Input is never held until a buildup finishes (`stagger` + above). Rapid switching must never leave two views mounted. 10. **Attention loops.** An idle hint that invites interaction holds off for several seconds at first, repeats rarely, stops during interaction, and restarts once the reset completes. 11. **Reduced motion collapses the choreography**: no delays, no movement, the group appears diff --git a/plugins/user-interface/reference/types/web/theming.md b/plugins/user-interface/reference/types/web/theming.md index e1871c1ac1d..936eb692f0e 100644 --- a/plugins/user-interface/reference/types/web/theming.md +++ b/plugins/user-interface/reference/types/web/theming.md @@ -253,8 +253,9 @@ mode gets a dark bar or dark mode gets a white one. Give each scheme its own: Match the value to the color at the very top of your page: the header background, not the brand color. In Next.js set it through the `viewport` export (`themeColor: [{ media, color }]`). If the app switches theme with a class rather than the OS setting, update the tag from JavaScript on -toggle. For an installed PWA, `apple-mobile-web-app-status-bar-style` and the manifest's -`theme_color`/`background_color` are the same decision. Read the colors from the project's tokens. +toggle. For an installed PWA, the manifest's `theme_color`/`background_color` are the same +decision. `apple-mobile-web-app-status-bar-style` takes a style keyword, not a color; Apple's meta +tag reference below lists them. Read the colors from the project's tokens. Never invent them. The `color-scheme` line in that block is for a two-theme app; a single-theme app follows section 2. @@ -269,11 +270,15 @@ fix the theme depends on; which browsers apply it is in the MDN pointer below. manifest `theme_color` and the meta tag that overrides it per scheme, ; Apple, Safari Web Content Guide, "Changing the Status Bar Appearance", - -- **As of**: 2026-10-29 + ; + Apple, Safari HTML Reference, "Supported Meta Tags", the + `apple-mobile-web-app-status-bar-style` entry, + +- **As of**: 2026-11-16 - **Recheck trigger**: MDN's page changes its Baseline status or what `media` does, Next.js renames the `themeColor` field, the manifest page gains a per-scheme `theme_color`, or Apple retires the - archived guide. + archived guide or the Safari HTML Reference's meta tag page, or changes the status-bar style + keywords that page lists. Autofilled inputs get the browser's pale yellow or blue background regardless of theme; if that breaks a dark form, override it: diff --git a/plugins/user-interface/skills/glossary/reference/easing-and-springs.md b/plugins/user-interface/skills/glossary/reference/easing-and-springs.md index 4ed8a55d47d..ed0331c9a46 100644 --- a/plugins/user-interface/skills/glossary/reference/easing-and-springs.md +++ b/plugins/user-interface/skills/glossary/reference/easing-and-springs.md @@ -125,7 +125,7 @@ parameter, which platforms express differently. ### Perceptual duration -How long a spring feels finished, though it keeps micro-settling. +How long until a spring looks done, though it keeps settling by tiny amounts after that. **Versus:** a duration ends an eased animation exactly; a spring's perceptual duration is when it looks done.