Design Engineering
Use Emil Kowalski's craft heuristics as a supplier beneath the active project
and Studio. Project tokens, behavior engines, and Studio motion defaults always
win; values in these references are examples when the project has no answer.
This Cortex adaptation folds the upstream review-animations,
improve-animations, and find-animation-opportunities workflows into one
owner instead of maintaining three copies of the same motion standard.
Source:
emilkowalski/skills, reviewed at
commit 70744e3816f1d93eafb697161a8b880a7384c5ff.
Pick a branch
| User need |
Branch |
| Build or polish an interaction |
craft |
| Review an animation diff or focused surface |
review |
| Survey existing motion and prepare a prioritized roadmap |
audit |
| Find places that would genuinely benefit from motion |
opportunities |
If invoked without a task, say you can help with craft, review, audit, or
opportunity finding and ask which surface to inspect.
Shared posture
- Train taste by studying why strong interfaces work, not by copying their
skin.
- Assume invisible details compound: response, origin, interruption, edge
cases, and reduced-motion behavior matter together.
- Default to restraint. The best motion change is often deletion.
- Judge frequency before style. Keyboard and very high-frequency actions
should feel immediate.
- Give every animation one functional purpose: feedback, spatial continuity,
state indication, explanation, or preventing a jarring change.
Workflow
- Load project truth. Read the active Studio profile when present, then
identify the stack, motion libraries, tokens, component engine, product
personality, and interaction frequency. This step is complete when a
recommendation cannot accidentally introduce a parallel motion language.
- Choose the branch. Do not combine a read-only audit with implementation
unless the user explicitly asks to move from one to the other.
- Load only the needed references:
- Animation Framework for the shared
decision gate, timing examples, springs, and debugging.
- Component Patterns for press,
popover, transition, clip-path, and drag behavior.
- Performance and Accessibility
for rendering, input, and user-preference constraints.
- Review and Audit for
review, audit,
or opportunities execution and output.
- Plan Template only after an audit finding
has been selected for a durable plan.
- Execute the branch.
craft: implement only the requested interaction, using the project's
existing primitives and tokens.
review: inspect the stated diff or surface and report motion findings;
do not edit.
audit: survey the requested codebase scope, vet every cited finding,
and stop for selection before writing plans. Source code remains
read-only.
opportunities: sweep for missing feedback or continuity, reject most
candidates through the gate, and report at most seven.
- Verify at the right level. Mechanical checks prove the code runs.
Slow-motion, frame-by-frame, interruption, reduced-motion, and real-device
checks prove the interaction feels right. Name any check you could not run.
Completion
craft is complete when the requested state graph works with project
primitives and tokens, build checks pass, and the interaction has been
feel-checked.
review is complete when every finding cites evidence and the verdict is
explicit.
audit is complete when the scoped motion surface is accounted for and
selected plans are self-contained enough for a context-free executor.
opportunities is complete when every reported candidate passed the full
gate and considered-but-rejected candidates are visible.
1---2name: emil-design-eng3description: Design-engineering craft and motion advisor. Use for UI polish, animation decisions, motion-only review, a codebase motion audit with implementation plans, or finding restrained animation opportunities.4---56# Design Engineering78Use Emil Kowalski's craft heuristics as a supplier beneath the active project9and Studio. Project tokens, behavior engines, and Studio motion defaults always10win; values in these references are examples when the project has no answer.1112This Cortex adaptation folds the upstream `review-animations`,13`improve-animations`, and `find-animation-opportunities` workflows into one14owner instead of maintaining three copies of the same motion standard.15Source:16[emilkowalski/skills](https://github.com/emilkowalski/skills), reviewed at17commit `70744e3816f1d93eafb697161a8b880a7384c5ff`.1819## Pick a branch2021| User need | Branch |22| --- | --- |23| Build or polish an interaction | `craft` |24| Review an animation diff or focused surface | `review` |25| Survey existing motion and prepare a prioritized roadmap | `audit` |26| Find places that would genuinely benefit from motion | `opportunities` |2728If invoked without a task, say you can help with craft, review, audit, or29opportunity finding and ask which surface to inspect.3031## Shared posture3233- Train taste by studying why strong interfaces work, not by copying their34 skin.35- Assume invisible details compound: response, origin, interruption, edge36 cases, and reduced-motion behavior matter together.37- Default to restraint. The best motion change is often deletion.38- Judge frequency before style. Keyboard and very high-frequency actions39 should feel immediate.40- Give every animation one functional purpose: feedback, spatial continuity,41 state indication, explanation, or preventing a jarring change.4243## Workflow44451. **Load project truth.** Read the active Studio profile when present, then46 identify the stack, motion libraries, tokens, component engine, product47 personality, and interaction frequency. This step is complete when a48 recommendation cannot accidentally introduce a parallel motion language.492. **Choose the branch.** Do not combine a read-only audit with implementation50 unless the user explicitly asks to move from one to the other.513. **Load only the needed references:**52 - [Animation Framework](references/animation-framework.md) for the shared53 decision gate, timing examples, springs, and debugging.54 - [Component Patterns](references/component-patterns.md) for press,55 popover, transition, clip-path, and drag behavior.56 - [Performance and Accessibility](references/performance-and-accessibility.md)57 for rendering, input, and user-preference constraints.58 - [Review and Audit](references/review-checklist.md) for `review`, `audit`,59 or `opportunities` execution and output.60 - [Plan Template](references/plan-template.md) only after an audit finding61 has been selected for a durable plan.624. **Execute the branch.**63 - `craft`: implement only the requested interaction, using the project's64 existing primitives and tokens.65 - `review`: inspect the stated diff or surface and report motion findings;66 do not edit.67 - `audit`: survey the requested codebase scope, vet every cited finding,68 and stop for selection before writing plans. Source code remains69 read-only.70 - `opportunities`: sweep for missing feedback or continuity, reject most71 candidates through the gate, and report at most seven.725. **Verify at the right level.** Mechanical checks prove the code runs.73 Slow-motion, frame-by-frame, interruption, reduced-motion, and real-device74 checks prove the interaction feels right. Name any check you could not run.7576## Completion7778- `craft` is complete when the requested state graph works with project79 primitives and tokens, build checks pass, and the interaction has been80 feel-checked.81- `review` is complete when every finding cites evidence and the verdict is82 explicit.83- `audit` is complete when the scoped motion surface is accounted for and84 selected plans are self-contained enough for a context-free executor.85- `opportunities` is complete when every reported candidate passed the full86 gate and considered-but-rejected candidates are visible.