MCPInstall

arc-mastery

Use when designing motion paths, character movement trajectories, gesture animations, or any motion that should feel natural rather than robotic.

Installs
526
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/dylantarre/animation-principles --skill arc-mastery
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads arc-mastery automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Arc Mastery

The Natural Path Principle

Almost all natural movement follows curved paths. Arms swing in arcs. Heads turn on arcs. Thrown objects travel parabolic arcs. When animation moves in straight lines, it immediately feels mechanical and artificial. Arcs are the signature of organic motion.

Core Theory

Anatomical basis: Bodies are systems of hinges and pivots. When a joint rotates, everything attached to it moves in an arc centered on that joint. Straight lines require mechanical rails—biology doesn't have those.

Physics basis: Gravity creates parabolic curves on projectiles. Momentum creates curved paths when direction changes. Straight-line direction changes require infinite force.

Arc Types

Circular arcs: Pure rotation around a single pivot (pendulum, door swing) Parabolic arcs: Projectile motion under gravity (jumps, throws) S-curves: Complex motion through multiple pivots (whip crack, spine movement) Figure-8 patterns: Continuous flowing motion (hips during walk, flowing cloth)

The Pivot Chain

Understanding arcs requires understanding pivot hierarchies:

  • Shoulder rotates → elbow travels an arc
  • Elbow rotates → wrist travels a compound arc
  • Wrist rotates → fingertips travel triple-compound arcs

Each joint adds complexity to the motion path of everything downstream.

Interaction with Other Principles

Follow through follows arcs: Appendages settle along curved paths, not straight returns.

Anticipation creates arc initiation: The wind-up often establishes the arc's direction.

Timing affects arc perception: Fast motion through arcs needs exaggerated curves to read clearly.

Overlapping action creates offset arcs: Secondary elements trace their own arc patterns behind the primary.

Domain Applications

UI/Motion Design

  • Page transitions: Elements should enter/exit on curved paths, not straight slides
  • Menu expansions: Items fan out on arcs from origin point
  • Gesture responses: Swipe follow-through curves naturally
  • Notification entries: Slight arc on slide-in prevents robotic feel
  • Dragging: Release trajectories should curve based on velocity vector

Character Animation

  • Walk cycles: Every limb segment traces arcs; hips follow figure-8
  • Head turns: Chin traces arc, doesn't translate linearly
  • Arm gestures: Hand paths curve even during "straight" pointing
  • Jumping: Parabolic body path with internal rotation arcs

Motion Graphics

  • Logo reveals: Elements following arc paths feel choreographed, not random
  • Text animation: Letter paths curving adds elegance
  • Infographic builds: Data points connecting along arcs creates flow

Game Design

  • Projectile physics: True parabolic arcs for believable ballistics
  • Character controllers: Turn animations following arcs prevent pivot-in-place
  • Camera movement: Arc-based camera paths feel cinematic

Common Mistakes

  1. Straight-line interpolation: Default animation software behavior—must be corrected manually
  2. Inconsistent arc centers: Motion arcs should have logical pivot points
  3. Symmetric arcs: Natural arcs are often asymmetric (fast one way, slow return)
  4. Flat arcs on fast motion: Quick movements need exaggerated arcs to register

The 3D Arc Challenge

In 3D, arcs must read from camera view. A perfect arc in world space may look straight or even reversed from certain angles. Always verify arc readability from final camera.

Arc Drawing Technique

Traditional method: Draw through the motion path with a single stroke. If your pencil naturally curves, the arc is working. If you must consciously redirect, the motion is likely too linear.

Implementation Heuristic

For any point-to-point motion: add a control point to create a curve. The control point should be offset perpendicular to the direct line, placed closer to the start for ease-out feeling, closer to end for ease-in. For complex motions, trace the intended path first—if it's not curved, it needs work.

Default arc height: 10-20% of travel distance for subtle organic feel, 30-50% for dramatic sweeping motion.

FAQ

What does the arc-mastery skill do?

Use when designing motion paths, character movement trajectories, gesture animations, or any motion that should feel natural rather than robotic.

How do I install arc-mastery?

Run npx skills add https://github.com/dylantarre/animation-principles --skill arc-mastery in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/arc-mastery/ (personal) or .claude/skills/arc-mastery/ (project).

Which AI agents can use arc-mastery?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is arc-mastery safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains arc-mastery?

It is published by dylantarre in dylantarre/animation-principles. It has 526 recorded installs.

More from dylantarre/animation-principles

View all →

video-motion-graphics

dylantarre/animation-principles

Use when creating After Effects compositions, Premiere Pro motion, video titles, explainer videos, or broadcast motion graphics.

Media & Creative2.4K installs

mobile-touch

dylantarre/animation-principles

Use when designing iOS/Android gestures, haptic feedback, touch interactions, or native mobile animations.

Mobile2.4K installs

framer-motion

dylantarre/animation-principles

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Frontend & Design1.7K installs

motion-designer

dylantarre/animation-principles

Use when designing visual motion systems, creating animation specifications, or when a designer needs guidance on crafting beautiful, meaningful movement.

Frontend & Design1.6K installs

micro-interactions

dylantarre/animation-principles

Use when designing small UI feedback moments like button states, toggles, form validation, loading indicators, or notification badges.

Frontend & Design1.4K installs

web-motion-design

dylantarre/animation-principles

Use when building CSS animations, JavaScript transitions, React/Vue motion, or any browser-based animation work.

Frontend & Design1.3K installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs