Primitives & Reference

Seven tools for searching animation primitives, retrieving personality rules, browsing reference breakdowns, and getting choreography recommendations.


search_primitives

Search the animation primitive library by keyword, personality, category, and source.

  • Name
    query
    Type
    string
    Description

    Search term to match against primitive names and descriptions.

  • Name
    personality
    Type
    string
    Description

    Filter by personality: cinematic-dark, editorial, neutral-light, or montage.

  • Name
    category
    Type
    string
    Description

    Filter by category: entrance, exit, emphasis, transition, or ambient.

  • Name
    source
    Type
    string
    Description

    Filter by source: engine, research, animate.style, or breakdown.

Try asking your AI:

"Search for entrance animations that work with the cinematic-dark personality"

"Find all blur-based primitives"


get_primitive

Retrieve full details for a named primitive, including CSS implementation, timing, and personality compatibility.

  • Name
    name
    Type
    string
    Description

    The exact name of the primitive to retrieve (e.g., fade-in, slide-up, blur-reveal).

Returns: Full CSS keyframes, recommended timing, easing curve, personality compatibility flags, and usage notes.

Try asking your AI:

"Show me the full CSS for the blur-reveal primitive"


get_personality

Get the complete definition for an animation personality including timing tiers, easing curves, camera preferences, and guardrails.

  • Name
    name
    Type
    string
    Description

    Personality name: cinematic-dark, editorial, neutral-light, or montage.

Returns: Timing tiers (fast/medium/slow/spring), easing curves, camera preferences, recommended primitives, and guardrails.

Try asking your AI:

"What primitives and timing does the editorial personality use?"


search_breakdowns

Search the reference breakdown library by keyword or technique.

  • Name
    query
    Type
    string
    Description

    Search term to match against breakdown titles and descriptions.

Returns: Matching breakdowns with titles, source references, and technique summaries.

Try asking your AI:

"Find breakdowns that use parallax scrolling techniques"


get_breakdown

Retrieve a detailed breakdown analysis of a real-world cinematic sequence.

  • Name
    name
    Type
    string
    Description

    The breakdown name to retrieve.

Returns: Step-by-step analysis of the sequence, primitives used, timing structure, and lessons learned.

Try asking your AI:

"Show me the Apple product launch breakdown"


get_reference_doc

Access animation principles, spring physics documentation, and other foundational reference material by slug.

  • Name
    slug
    Type
    string
    Description

    Reference document slug: animation-principles, spring-physics, or other available docs.

Returns: Full reference document content.

Try asking your AI:

"Show me the spring physics reference documentation"


recommend_choreography

Recommend animation choreography for a scene. Returns a structured plan with ordered primitives, timing, stagger patterns, and implementation notes.

  • Name
    intent
    Type
    string
    Description

    Natural language description of what you want to animate (e.g., "hero section entrance", "page transition", "data reveal").

  • Name
    personality
    Type
    string
    Description

    The personality to use for recommendations. Determines which primitives and timing tiers are available.

Returns: A structured choreography plan with ordered primitives, timing values, stagger patterns, and implementation notes.

Try asking your AI:

"Recommend choreography for a pricing page reveal using the editorial personality"

"I need a dramatic product showcase entrance for cinematic-dark"

Was this page helpful?