The Popcorn skill
The MCP server gives your agent tools for creating movies, polling progress, sending follow-up messages, checking account state, and searching reusable elements. The Popcorn skill teaches the agent how to use them well — how to write a strong brief, how to poll, how to recover when a movie completes without a final video, how to share studio links back to the user, and how to bring existing characters, props, and sets into a movie.
Add the skill to your agent
Section titled “Add the skill to your agent”Paste this prompt into Claude, Tasklet, or any agent that supports external skills:
Add the skill found at https://popcorn.co/docs/popcorn-skill.md as a new skill.The agent will fetch the skill and remember it.
What the skill teaches
Section titled “What the skill teaches”- How to translate a user request into a strong
create_moviebrief. - How to use
search_elementswhen a user mentions an existing/global element or@reference, and how to browse available elements when the user has not named one yet. - How to pass selected characters, props, and sets as
tagged_elementstocreate_movieorsend_movie_message. - The recommended polling interval for
get_movie(every 15–30s). - The “completed without a video” recovery pattern (call
send_movie_messageto nudge Popp instead of reporting success). - How to share the studio link (
https://popcorn.co/studio/{id}) along with the video URL. - When to call
send_movie_messagefor iteration vscreate_moviefor a new movie. - How to read Popp’s reply with
get_movie_messages.
Why bother?
Section titled “Why bother?”Without the skill, an agent will still work — it knows the tool descriptions. But the skill captures the operational knowledge that makes the difference between “produces a movie” and “produces a movie reliably and hands back a useful response”.
If your agent supports external skills, always add the Popcorn skill.