tanshilongmario/clipshot

Convert scripts, storyboards, and character or scene settings into cinematic-grade nine-grid storyboards and timeline shots; After storyboarding, users can choose whether to create independent finished keyframes based on the storyboard and footage.

This repository is an independent skill that complies with the Agent Skills specification: cinematic-storyboard-design. It is suitable for Cursor, Codex, and other agents compatible with this specification. examples/ contains the case shot list and generated prompts; Storyboards and other materials are not stored by default and are only stored locally.

What does it do?

Skill first understands the narrative, character relationships, space, and intended use, then disassembles the shots instead of directly producing the finished video or concept poster. Default output:

• A minimalist creative understanding: core conflict, emotional curves, spatial relationships, and visual motifs
• A strictly 3×3 nine-grid production storyboard
• A storyboard interpretation chart with a timecode
• Add special shots, transitions, and continuity cues as needed
• Inquiry about keyframe production after storyboard delivery; Only after the user agrees and confirms the material mapping will the final keyframe be output

By default, a set of director’s recommended proposals is output. Only during the exploration phase, when users clearly request it, or when both viewing perspectives exist within the same storyline, provide both A/B options. The dual schemes have the same anchor point for plot rhythm and continuity, with at least three aspects—viewing perspective, composition, shot control, editing, camera movement, or transitions—forming a complete set of differences.

Applicable and Not Applicable

Applicable Conditions

• Break down shots of narrative films, advertisements, music videos, and short dramas
• Scene scheduling, camera movement, transitions, and single-frame zooming
• Action Cinematography: Dutch angles, golden ratio, in-frame splitting, extreme edge cutting, and start and end points for continuous camera movement
• Storyboards readable by directors, cinematographers, and action departments
• Create independent keyframes based on confirmed storyboards and user characters, scenes, and art materials

Not Applicable

• Directly generate realistic films
• Ordinary concept posters or delicate illustrations
• Forcing a long script into a nine-grid grid

Installation

The installation directory name must be cinematic-storyboard-design to match the name field in Skill.

Cursor User Level

Place the cloned folder into:

• ~/.cursor/skills/cinematic-storyboard-design
• or ~/.agents/skills/cinematic-storyboard-design

Common Windows paths:

Cursor Project Level

Copy this repository into the project’s internal structure:

Or:

Imported from GitHub

Open Customize → Rules → Add Rule → Remote Rule (Github) in Cursor, and enter:

Other compatible agents

The repository root directory contains SKILL.md. Codex can use the display name and default trigger sentence in agents/openai.yaml.

Usage

Call out the skill in the dialogue and provide the script or the segment to be handled this time. You can also use it directly:

Before generation, these three items must be confirmed; missing any one will be followed up first: