cuelight-film

Create and validate film screenplays with hierarchical YAML metadata and DOCX export.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cuelight/agent-skills --skill cuelight-film
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cuelight-film
Source: https://github.com/cuelight/agent-skills/tree/main/cuelight-film
Command: npx skills add https://github.com/cuelight/agent-skills --skill cuelight-film

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, python-docx, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the complexity of managing end-to-end film projects by providing a standardized, production-grade workflow for creating screenplays, maintaining structured local metadata, enforcing quality gates, and exporting professional documents.

Core Features & Use Cases

  • Film Structure Planning: Generate three-act and eight-sequence outlines for feature films and shorts.
  • Screenplay Creation: Write properly formatted, filmable screenplay blocks with scene headings, action, dialogue, and transitions.
  • Quality Assurance: Run automated checks for playable capacity, dialogue readability, spatial logic, and template detection, combined with Agent-owned literary and commercial review gates.
  • DOCX Export: Convert validated screenplays into formatted Word documents with proper styling and page numbering.
  • Local Metadata Maintenance: Organize project data in a hierarchical YAML structure under the film-data directory covering acts, sequences, scenes, beats, segments, shots, and prompts.

Quick Start

Use the cuelight-film skill to create a three-act film outline and write the first act screenplay, then validate it with the quality check script before exporting to DOCX.

Frequently Asked Questions about cuelight-film

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate screenplay structure before exporting to DOCX?

You can validate screenplay structure by running automated quality gates that check playable capacity, dialogue readability, spatial logic, and template detection using Python with PyYAML and python-docx before exporting to DOCX.

What is a three-act film structure and how do I generate a sequence outline?

A three-act film structure divides a screenplay into setup, confrontation, and resolution. This Skill generates three-act and eight-sequence outlines for feature films and shorts using a hierarchical YAML-based schema.

Does this screenplay tool work with YAML metadata for scene breakdowns?

Yes, it maintains structured local metadata in a hierarchical YAML structure covering acts, sequences, scenes, beats, segments, shots, and prompts under the film-data directory.

Do I need Python and python-docx to export a formatted screenplay to Word?

Yes, you need Python with PyYAML and python-docx installed to generate quality-checked screenplay documents and convert validated screenplays into formatted Word documents with proper styling and page numbering.

Can I run quality checks on dialogue readability and spatial logic for film projects?

Yes, quality assurance checks run automated validation for playable capacity, dialogue readability, spatial logic, and template detection, combined with Agent-owned literary and commercial review gates for film projects.

What's the best way to organize film project data for production leaf synchronization?

Organize film project data in a hierarchical YAML-based film-data schema covering acts down to shots, enforcing duration aggregation and production leaf synchronization for standardized end-to-end management.