Skip to content

Conversation

@shrishmanglik
Copy link

Introduces a comprehensive video prompt architecture for achieving Hollywood-quality output from AI video generators (Sora 2, VEO 3, Runway, Kling).

Key components:

  • SKILL.md: Complete framework documentation with prose-first methodology
  • References: Shot vocabulary, material poetry, lighting emotion, director signatures
  • Scripts: Python prompt generator with dataclass-based structure
  • Templates: Luxury product, food/beverage, and nature/environment templates

The framework provides:

  • Frame-by-frame temporal control with Micro-Moment Registry
  • Physics-through-poetry material descriptions (not technical specs)
  • AI limitation workarounds for hands, liquids, steam, and text
  • Comprehensive lighting-as-emotion vocabulary
  • Director signature references for visual language

Introduces a comprehensive video prompt architecture for achieving Hollywood-quality
output from AI video generators (Sora 2, VEO 3, Runway, Kling).

Key components:
- SKILL.md: Complete framework documentation with prose-first methodology
- References: Shot vocabulary, material poetry, lighting emotion, director signatures
- Scripts: Python prompt generator with dataclass-based structure
- Templates: Luxury product, food/beverage, and nature/environment templates

The framework provides:
- Frame-by-frame temporal control with Micro-Moment Registry
- Physics-through-poetry material descriptions (not technical specs)
- AI limitation workarounds for hands, liquids, steam, and text
- Comprehensive lighting-as-emotion vocabulary
- Director signature references for visual language
@shrishmanglik
Copy link
Author

NA

@wshobson
Copy link
Owner

Hi @shrishmanglik,

Thanks for this PR — the PROMETHEUS framework is genuinely well-researched and the content quality is excellent. The "prose over constraints" philosophy is a thoughtful insight into how AI video generators actually work, and the director signature references are a valuable resource.

However, this PR needs some structural modifications before it can be merged. Every plugin in this repository follows a consistent pattern, and this one is currently incomplete.

Required Changes

1. Add an Agent Definition

Every plugin needs an agents/ directory with at least one agent. Please add:

plugins/video-prompt-engineering/
├── agents/
│   └── video-prompt-engineer.md   ← ADD THIS
└── skills/
    └── prometheus-framework/

The agent file should follow the standard format (see any existing agent in the repo for reference). Something like:

---
name: video-prompt-engineer
model: sonnet
description: Expert in crafting prompts for AI video generators (Sora, VEO, Runway, Kling) using the PROMETHEUS framework for Hollywood-quality output.
---

# Video Prompt Engineer

[Description of capabilities, when to use, etc.]

2. Consider Adding a Command (Optional but Recommended)

Most plugins include a commands/ directory with slash commands. You could add something like:

plugins/video-prompt-engineering/
├── agents/
├── commands/
│   └── prometheus.md   ← OPTIONAL
└── skills/

This would let users invoke /prometheus to generate video prompts interactively.

What's Already Good

  • ✅ The SKILL.md is comprehensive and well-structured
  • ✅ The reference materials (director signatures, lighting emotion, etc.) are valuable
  • ✅ The Python generator is clean with proper dataclasses and type hints
  • ✅ The AI limitation workarounds section is practical and insightful
  • ✅ The templates provide useful starting points

Questions to Consider

  1. Should this be part of a broader "generative-ai-prompting" category, or standalone?
  2. Would you want to add agents for specific platforms (e.g., sora-specialist, runway-specialist)?

Once you add the agent definition, this should be ready for another review. Let me know if you have any questions about the plugin structure!

Copy link
Owner

@wshobson wshobson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requesting changes as outlined in my comment above. The content quality is excellent, but the plugin needs an agents/ directory with at least one agent definition to match the project structure. Once that's added, happy to re-review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants