Agent Copywriting

In the context of the Agent Board, copywriting refers to the automated generation of text content—such as titles, captions, and script segments—that is injected into Remotion compositions. To ensure high-quality video output, agents must follow specific linguistic and structural patterns that align with visual timing and legibility.

Structuring Content for Visual Impact

When generating copy for video, brevity is the primary constraint. Agents should prioritize "Information Density" over grammatical complexity.

Title and Headline Constraints

Headlines in Remotion compositions often use fixed font sizes or specific scaling logic (see measuring-text.md).

• Max Length: Limit headlines to 45 characters to avoid overflow or excessive font shrinking.
• Punchiness: Use active verbs. Instead of "A new way to build videos is here," use "Build Videos Faster."

Text Animation Formatting

Different components require different copy structures to look professional.

• Typewriter Effect: Works best with continuous sentences. Avoid using too many commas, as each character delay adds to the total duration.
• Word Highlighting: Ensure sentences are broken into natural "rhythmic" chunks. The display-captions.md logic relies on combineTokensWithinMilliseconds; shorter, punchy words create a more dynamic "TikTok-style" feel.

Writing for Automated Captions

If the agent is generating scripts for the display-captions skill, the copy must be optimized for readability.

| Feature | Best Practice | | :--- | :--- | | Sentence Length | Keep sentences under 10-12 words to ensure they fit within 1-2 lines. | | Punctuation | Use standard punctuation. Automated transcription and alignment tools use periods and commas to determine pauses. | | Numbers | Use digits (10) instead of words (ten) for better legibility at high speeds. |

Dynamic Copy Injection

Agents should leverage defaultProps and calculateMetadata to ensure copy fits the composition's technical constraints.

Using Props for Localization and Brand Voice

Pass brand-specific terminology via props. This allows the Remotion component to handle the styling while the agent handles the messaging.

// Example of an Agent-generated prop object
const props = {
  title: "Q3 Growth Report",
  highlightWord: "Growth",
  subtitle: "Revenue up by 22% year-over-year.",
  brandVoice: "professional-bold"
};

Prompting the Agent for Copy

When requesting copy from an LLM to feed into the Agent Board, use the following technical constraints in the prompt:

• Constraint: "Provide a JSON object with title (max 30 chars), subtitle (max 60 chars), and cta (max 15 chars)."
• Constraint: "Break the script into segments of no more than 4 words for high-energy text animations."

Persuasive Writing in Automated Content

To maximize engagement, agents should follow the "Hook-Value-Action" framework:

1. The Hook (Frame 0-60): A bold statement or question in the title prop.
2. The Value (Middle Duration): Concise bullet points or short sentences delivered via Sequence or Audio components.
3. The Action (Last 2 Seconds): A clear, single-word or short-phrase Call to Action (CTA).

Technical Implementation Notes

• Character Escaping: Agents must ensure that copy containing quotes or special characters is properly escaped for JSON serialization before being passed to defaultProps.
• Text Measurement: For compositions using the measuring-text skill, the agent should provide a "fallback string" if the primary copy is too long to fit the container.
• Font Loading: If the agent selects a specific font for the copy, ensure it is loaded via @remotion/google-fonts to prevent layout shifts during the render process.