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.
Always validate before compiling. Personality violations can result in animations that feel inconsistent or break the intended tone of your project.
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_sequenceorrecommend_choreography.
- Name
format- Type
- string
- Description
Output format:
css(default),tailwind, orstyled-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, orlabel.
- 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?"