Cineprompt

What This Skill Does

The CinePrompt skill transforms the often complex task of writing AI video prompts into a structured, reliable process. By bridging the gap between natural language descriptions and the CinePrompt.io platform, it allows you to generate professional-grade, shareable video prompts without ever leaving your terminal or chat interface. The skill interprets your vision—whether it's a gritty cinematic shot or a soft documentary style—and converts it into a structured CinePrompt state JSON. It then communicates with the CinePrompt API to store that state and generate a unique, shareable URL, along with a refined text prompt ready to be pasted into tools like Runway, Pika, or Sora.

Installation

To install this skill, run the following command in your terminal:

clawhub install openclaw/skills/skills/belafontelabs/cineprompt

Ensure you have an active CinePrompt API key. You can authenticate by setting the CINEPROMPT_API_KEY environment variable or by passing the --api-key flag during execution. For internal or owner-level operations that bypass Pro-subscription checks, use the CINEPROMPT_SERVICE_KEY environment variable.

Use Cases

• Pre-production Planning: Rapidly prototype a sequence of shots for a storyboard and share the URLs with team members for feedback.
• Consistency Across Tools: Generate standardized prompts that ensure stylistic uniformity when moving between different AI video generators.
• Prompt Engineering: Leverage the 'complex' mode to dial in specific film stocks, camera bodies, and lighting setups that yield higher-quality AI video outputs than generic text prompts.
• Workflow Automation: Batch-create a collection of prompt variants for a single subject by piping configurations through the skill's script.

Example Prompts

1. "Create a complex cinematic prompt for a shot of a 30-year-old explorer standing on a foggy mountain peak, wearing tactical gear, looking out at the horizon, 35mm film style."
2. "Generate a CinePrompt link for a simple, moody object shot of a rusted, vintage pocket watch sitting on a velvet table, with a dramatic, slow-motion feel."
3. "Build a prompt for a creature shot featuring a small, bioluminescent forest sprite moving quickly through glowing flora in a dark, atmospheric forest environment."

Tips & Limitations

• Complexity Matters: Always specify 'simple' or 'complex' in your request. Use 'complex' to unlock professional cinematographic fields like camera, lens, and color science settings.
• State Integrity: While the skill handles JSON transformation, ensure your descriptions provide enough detail to fill the necessary fields in the CinePrompt schema. If you provide vague descriptions, the skill will use sensible defaults.
• API Requirements: This skill requires a Pro CinePrompt account for standard operations. If your API key is invalid or expired, the create-share-link.js script will fail to generate your URL.