prop-extractor

What This Skill Does

The prop-extractor skill acts as a specialized AI agent module designed to parse narrative scripts or screenplay texts to identify, classify, and document significant props. By extracting key items such as weapons, keepsakes, and magical artifacts, the skill generates structured 'Prop Cards' that maintain visual consistency across multiple cinematic shots. This process ensures that every item critical to the plot or character development is tracked via a unique PropKey, which serves as a consistent reference point for the entire production pipeline. It effectively bridges the gap between written descriptions and visual asset generation.

Installation

To integrate the prop-extractor into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/hexiaochun/prop-extractor

Use Cases

• Pre-production Planning: Automate the cataloging of items directly from a completed screenplay to streamline the prop-building or procurement process.
• Asset Generation: Generate standardized image generation prompts for character-specific equipment, ensuring that visual elements remain consistent across scenes.
• Narrative Logic Control: Track the movement and significance of plot-critical items (e.g., keys, letters, or weapons) to ensure they are referenced correctly throughout the storyboard.

Example Prompts

1. "Here is the script for Scene 5. Extract all items carried by the protagonist and generate their prop cards using the 'cyberpunk-neon' style base."
2. "Create a prop card for the 'Soul-Binding Pendant' mentioned in the latest draft. Use @hero_char as the owner and include special glowing effects in the description."
3. "Analyze the attached battle sequence and identify which weapons are critical to the fight, outputting them in the required PropKey format."

Tips & Limitations

• Focus on Significance: The skill is designed to ignore generic background clutter. Only props that drive the plot or carry emotional weight are prioritized. Ensure your script highlights these items clearly.
• Style Consistency: Always provide a robust 'STYLE_BASE' to ensure that the image generation prompts produced by the skill match your project's overall visual aesthetic.
• Manual Review: While the skill captures essential details like material, size, and function, human oversight is recommended to verify that the generated '劇情意义' (plot significance) aligns with the broader creative vision.