design-motion-sequencing
Skill0 starsChanged 4 months agoISCView on GitHub
Design motion as comprehension order rather than decoration. Use when adding or revising web animation, interaction timing, section-to-section scroll cues, hero-to-next-section handoffs, reveal sequences, or reduced-motion/JavaScript-off behavior.
In this repository11 other files it gives its agents.
- mockup-to-codeSkill
- design-copy-structureSkill
- design-whitespaceSkill
- lp-interaction-qaSkill
- photo-art-directionSkill
- raster-texture-reconstructionSkill
- responsive-image-deliverySkill
- seamless-section-wavesSkill
- typographySkill
- visual-device-inventorySkill
- visual-qa-pixel-polishSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
Use motion to reveal information in the order users should understand it.
- Distinctive: line 27
Avoid unnecessary hover effects or infinite loops.
- Distinctive: line 42
Use one cue per boundary, subordinate to the primary CTA.
- Very specific: line 43
Prefer translateY(4px–8px) plus opacity around .7–1.
- Distinctive: line 45
Use a calm 1400–2200ms cycle and a smooth ease.
- Very specific: line 47
If clickable, point to an existing same-document fragment.
- Distinctive: line 51
Keep the section bridge and next heading structurally visible with no JS.
- Distinctive: line 59
Do not animate all four elements merely because they appear in the order.
- Very specific: line 74
When mockup-to-code owns the page, runtime proof remains motion-report/v1 from motion-check.mjs.
- Distinctive: line 82
Ensure motion supports reading flow and focus.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Design Motion Sequencing
Overview
Use motion to reveal information in the order users should understand it. Static composition must already communicate the same order. Motion may point, confirm, or pace; it may not rescue missing hierarchy or hidden content.
Workflow
1) Define the comprehension order
- Identify the 3–5 key elements users must notice.
- Assign a sequence and timing for each.
- For a cross-section handoff, include the outgoing promise, boundary bridge, directional cue, and incoming heading/preview in that order.
2) Choose 1–2 motion motifs
- Pick a minimal set of motion styles (e.g., fade+slide, scale+blur).
- Reuse motifs consistently across the page.
3) Limit motion to meaning
- Animate only what changes understanding: hero, proof, CTA, key comparison.
- Avoid unnecessary hover effects or infinite loops.
4) Contract every runtime state
- Preserve the user's verbatim motion/continuity request in
motion.sourceRef. - Bind every target to a manifest id and keep the static QA state
settled. - Define normal,
prefers-reduced-motion: reduce, and JavaScript-disabled behavior before implementation. - In reduced motion and JavaScript-off states, critical copy, controls, the section bridge, and incoming heading remain visible without waiting.
Cross-section directional cue
A small repeating cue is a narrow exception to the default "avoid infinite loops" rule. Allow it only when it communicates that content continues below.
- Use one cue per boundary, subordinate to the primary CTA.
- Prefer
translateY(4px–8px)plus opacity around.7–1; do not scale, rotate, bounce, blur, or move layout boxes. - Use a calm 1400–2200ms cycle and a smooth ease. The cue may repeat while visible, but it is a direction signal, not ambient decoration.
- If clickable, point to an existing same-document fragment. If not clickable,
keep it
aria-hiddenand do not imply button affordance. - Disable the animation under reduced motion and leave the cue in its settled visible state.
- Keep the section bridge and next heading structurally visible with no JS.
For an FV-to-next-section handoff, motion follows the composition:
hero promise / CTA → cross-section field → SCROLL cue → next eyebrow/titleDo not animate all four elements merely because they appear in the order. A single cue can express the transition while the bridge and next preview remain static.
Motion plan output
Return a parent-manifest-ready plan, not animation prose:
sourceRef {path, quote}- ordered manifest target ids
- one or two motifs with trigger, properties, duration, easing, iterations, and comprehension meaning
visualQaState: settledreducedMotion {strategy: settled-static, contentVisibleWithoutJs: true}
When mockup-to-code owns the page, runtime proof remains
motion-report/v1 from motion-check.mjs. If the standard runner fails after
its bounded retries, stop retrying and produce one fallback report containing
the attempted command/error plus equivalent normal, reduced-motion, and
JavaScript-off measurements. Never call an unmeasured motion state complete.
Output expectations
- Provide motion rules and target elements.
- Ensure motion supports reading flow and focus.
- State why any infinite iteration is directional rather than decorative.
- State the settled/reduced/JavaScript-off result separately.
Resources
references/
references/motion-ordering.mdfor sequencing rules and anti-average constraints.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

