Scene Authoring

Eight tools for classifying content, generating structured scenes from briefs, validating choreography, compiling motion timelines, and authoring editorial canvas layouts.


analyze_scene

Classify a scene's content type, visual weight, motion energy, and intent tags. Produces semantic annotations used by downstream planning tools.

  • Name
    scene
    Type
    object
    Description

    The scene object to analyze.

Returns: Content type classification, visual weight score, motion energy rating, intent tags, and semantic annotations.

Try asking your AI:

"Analyze this scene for content type and visual weight"

"Classify the motion energy and intent tags for my hero scene"


generate_scenes

Convert a natural language brief into classified assets and validated scene JSON with auto-annotations. Runs the full brief-to-scenes pipeline in one call.

  • Name
    brief
    Type
    string
    Description

    Natural language description of the animation you want to create.

  • Name
    personality
    Type
    string
    Description

    Optional personality to constrain the generated scenes.

  • Name
    template
    Type
    string
    Description

    Optional brief template name to use as a starting structure.

Returns: An array of structured scene objects with beats, primitives, timing, element targeting, and semantic annotations.

Try asking your AI:

"Generate scenes for a SaaS landing page hero with staggered text and image reveals"

"Create animation scenes for an onboarding flow using the neutral-light personality"


validate_choreography

Validate animation choreography against personality guardrails. Catches violations before you compile.

  • Name
    primitives
    Type
    string[]
    Description

    Array of primitive names to validate.

  • Name
    personality
    Type
    string
    Description

    The personality to validate against.

Returns: Pass/fail result with specific violations listed. Common violations include using 3D primitives in a personality that forbids them, or mixing timing tiers incorrectly.

Try asking your AI:

"Validate these primitives against the editorial personality: blur-reveal, perspective-tilt, fade-in"


compile_motion

Compile scene motion (groups, stagger, camera) into a timeline. Takes a planned sequence and produces production-ready output.

  • Name
    sequence
    Type
    object
    Description

    The planned sequence to compile, as returned by plan_sequence or recommend_choreography.

  • Name
    format
    Type
    string
    Description

    Output format: css (default), tailwind, or styled-components.

Returns: Complete timeline with keyframes, animation declarations, and timing functions.

Try asking your AI:

"Compile this sequence to production CSS"

"Compile the choreography as Tailwind utility classes"


critique_motion

Critique a compiled timeline for quality issues. Checks 13 rules covering timing consistency, easing, performance, and personality compliance.

  • Name
    css
    Type
    string
    Description

    The compiled CSS to critique.

  • Name
    personality
    Type
    string
    Description

    The personality the animation should conform to.

Returns: Quality assessment with per-rule scores, timing consistency analysis, performance impact flags, and personality alignment.

Try asking your AI:

"Critique this compiled animation for performance and editorial personality compliance"


create_editorial_canvas_scene

Create a flat, art-directed editorial canvas scene. Produces a scene optimized for editorial-style compositions with precise spatial layout.

  • Name
    content
    Type
    object
    Description

    Content elements to arrange on the canvas (text blocks, images, shapes).

  • Name
    style
    Type
    string
    Description

    Optional style direction for the canvas layout.

Returns: A scene object with editorial canvas layout, element positions, and art direction metadata.

Try asking your AI:

"Create an editorial canvas scene with a large headline and supporting image"


recommend_editorial_layout

Recommend an editorial layout for given content. Analyzes content types and proportions to suggest optimal spatial arrangements.

  • Name
    content
    Type
    object
    Description

    Content elements to lay out (text, images, video, data).

  • Name
    aspect_ratio
    Type
    string
    Description

    Target aspect ratio (e.g., "16:9", "1:1", "9:16").

Returns: Layout recommendation with element positions, sizing, and visual hierarchy notes.

Try asking your AI:

"Recommend an editorial layout for a hero with headline, subhead, and product screenshot"


recommend_type_treatment

Recommend typography animation treatment for text content. Suggests kinetic type approaches based on content length, hierarchy, and personality.

  • Name
    text
    Type
    string
    Description

    The text content to animate.

  • Name
    role
    Type
    string
    Description

    Text role: headline, subhead, body, caption, or label.

  • Name
    personality
    Type
    string
    Description

    Personality to constrain recommendations.

Returns: Recommended type treatment with animation primitives, timing, and implementation notes.

Try asking your AI:

"Recommend a type treatment for my hero headline using the prestige style"

"What typography animation works best for a short caption in cinematic-dark?"

Was this page helpful?