Reference Library

Tools for searching and retrieving primitives, personalities, style packs, and reference breakdowns.

search_primitives

Search animation primitives across all sources (engine, research, animate.style, breakdown, compound). Filter by name, personality, category, or source. Returns matching primitives with ID, name, duration, personality affinity, source, and category.

Name
query
Type
string
Description
Search term to match against primitive name or ID (case-insensitive).
Name
personality
Type
string
Description
Filter by personality affinity: cinematic-dark, editorial, neutral-light, montage, or universal.
Name
category
Type
string
Description
Filter by category — e.g., Entrances, Exits, Reveals / Staggers, Continuous / Ambient, Content Effects, Interactions, Transitions, Typography, Attention Seekers.
Name
source
Type
string
Description
Filter by source: engine, research, animate.style, breakdown, or compound (JS-driven multi-step primitives).

Try asking your AI:

"Search for Entrances that work with the cinematic-dark personality"

"Find all primitives in the Attention Seekers category"

get_primitive

Get full details for a single animation primitive by ID. Returns catalog data (if engine primitive) plus CSS implementation from the registry. Use search_primitives first to find the ID.

Name
id
Type
string
Description
Required. Primitive ID (e.g., cd-focus-stagger, ct-iris-open, bk-sparse-breathe).

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

Try asking your AI:

"Show me the full CSS for the cd-focus-stagger primitive"

get_personality

Get the full personality definition including timing tiers, easing curves, characteristics, camera behavior rules (allowed movements, parallax, DOF, ambient motion), default primitives, and recommended primitives by category.

Name
slug
Type
string
Description
Required. Personality slug — cinematic-dark, editorial, neutral-light, or montage.

Returns: Timing tiers (fast/medium/slow/spring), easing curves, characteristics, camera behavior rules, default primitives, and recommended primitives by category.

Try asking your AI:

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

list_personalities

List all available animation personalities with summary descriptions.

No parameters required.

Try asking your AI:

"What animation personalities are available?"

get_style_pack

Retrieve a pre-configured style pack with bundled primitives and timing.

Name
name
Type
string
Description
The style pack name to retrieve.

Returns: Bundled primitives with personality-aligned timing and easing for quick starts.

Try asking your AI:

"Get me the hero-entrance style pack"

get_reference_doc

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

Name
name
Type
string
Description
Required. Reference document name (e.g., animation-principles, spring-physics).

Try asking your AI:

"Show me the spring physics reference documentation"

search_breakdowns

Search animation reference breakdowns. Filter by personality, quality tier, type, or tag.

Name
personality
Type
string
Description
Filter by personality: cinematic-dark, editorial, neutral-light, montage, or universal.
Name
quality
Type
string
Description
Filter by quality tier: exemplary, strong, or interesting.
Name
type
Type
string
Description
Filter by type: gif, video, website, or motion-study.
Name
tag
Type
string
Description
Filter by tag (e.g., stagger, grid, onboarding, spring).

Returns: Matching breakdowns with metadata — slug, title, personality, quality tier, and tags.

Try asking your AI:

"Find exemplary breakdowns tagged with stagger"

get_breakdown

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

Name
slug
Type
string
Description
Required. Breakdown slug (e.g., linear-homepage, dot-grid-ripple, nume-ai-chat-dashboard).

Returns: Full markdown analysis including signature moments, timing map, and extracted primitives.

Try asking your AI:

"Show me the linear-homepage breakdown"

Reference Library

Contents