agentleFS
mocchaleramocchalera/mockup-to-code-skill/skills/design-motion-sequencing/SKILL.md

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.

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
  1. Distinctive:

    Use motion to reveal information in the order users should understand it.

    line 9
  2. Distinctive:

    Avoid unnecessary hover effects or infinite loops.

    line 27
  3. Distinctive:

    Use one cue per boundary, subordinate to the primary CTA.

    line 42
  4. Very specific:

    Prefer translateY(4px–8px) plus opacity around .7–1.

    line 43
  5. Distinctive:

    Use a calm 1400–2200ms cycle and a smooth ease.

    line 45
  6. Very specific:

    If clickable, point to an existing same-document fragment.

    line 47
  7. Distinctive:

    Keep the section bridge and next heading structurally visible with no JS.

    line 51
  8. Distinctive:

    Do not animate all four elements merely because they appear in the order.

    line 59
  9. Very specific:

    When mockup-to-code owns the page, runtime proof remains motion-report/v1 from motion-check.mjs.

    line 74
  10. Distinctive:

    Ensure motion supports reading flow and focus.

    line 82

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-hidden and 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/title

Do 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: settled
  • reducedMotion {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.md for sequencing rules and anti-average constraints.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.