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.