openstoryline-use

openstoryline-use is a skill for Claude Code from FireRedTeam/FireRed-OpenStoryline. It costs 80 tokens per session (3,677 once invoked), scanned A, original, Apache-2.0.

A workflow for using OpenStoryline, a video-editing agent that turns natural-language instructions and your media files into edited videos. It covers starting its local services, creating editing sessions, and continuing revisions.

In plain words
What is it for?
Use it to start OpenStoryline, provide source media and editing requests, revise a video over multiple turns, and verify the generated MP4 files.
Why use it?
It provides a repeatable way to run an edit from start to rendered video and keep making changes in the same session. It also helps check that the resulting video files were actually produced.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: built for openclaw.

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/yourname/Desktop/code/Openstoryline/FireRed-Openstoryline.

Good fit Use it to start OpenStoryline, provide source media and editing requests, revise a video over multiple turns, and verify the generated MP4 files.

Compare 6 skills from other repositories ↓
About the project

FireRed-OpenStoryline is an AI video-editing agent that turns natural-language instructions into planned and coordinated editing actions. It is for beginners, creative users, and developers who want help searching media, generating scripts, selecting music or narration, and assembling videos through conversation. The catalogue contains reusable Style Skills for guiding consistent video-production workflows.

FireRedTeam/FireRed-OpenStoryline · 3,389 stars · on GitHub

Install

Getting it into your agent

There is no command for this one: it runs only inside a plugin, and the catalogue could not identify which plugin ships it. The source is linked below.

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for openstoryline-use

README.md
[![agentmods](https://agentmods.dev/badge/skills/fireredteam/firered-openstoryline/openstoryline-use/github.svg)](https://agentmods.dev/skills/fireredteam/firered-openstoryline/openstoryline-use)
Your own site
<a href="https://agentmods.dev/skills/fireredteam/firered-openstoryline/openstoryline-use"><img src="https://agentmods.dev/badge/skills/fireredteam/firered-openstoryline/openstoryline-use/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for openstoryline-use

Your own site · 80×15
<a href="https://agentmods.dev/skills/fireredteam/firered-openstoryline/openstoryline-use"><img src="https://agentmods.dev/badge/skills/fireredteam/firered-openstoryline/openstoryline-use.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 80 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,677 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00080 $0.03677
Opus 5 $0.00040 $0.01839
Sonnet 5 $0.00016 $0.00735
Haiku 4.5 $0.00008 $0.00368

Measured 12d ago against content hash 039576d90fae, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

openstoryline-use scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/bridge_openstoryline.py, scripts/feishu_file_sender.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s -X POST "http://127.0.0.1:8005/api/sessions"
.claude/skills/openstoryline-use/SKILL.md · 337 lines

How it starts

The opening of the file, as written. The whole thing — 337 lines — stays where its author put it; the contents beside it link to each section on GitHub.

OpenStoryline Usage Skill

你负责在“已安装完成”的前提下,执行 OpenStoryline 的实际剪辑流程。 OpenStoryline 是一个剪辑 Agent,用户可使用自己的素材,通过自然语言对话的方式剪辑视频。内置素材搜索、内容理解、生成字幕、文字转语音等功能,用户可以多次提出具体的剪辑/修改意见。

目标是:使用已有脚本,稳定地完成一次从启动服务到产出视频的闭环;并且支持在同一个 session_id 上继续对话、二次编辑、重新生成新视频。

Scope

此技能只处理“使用与剪辑”:

  1. 检查并修改 config.toml 的必要字段。
  2. 启动 MCP server。
  3. 启动 uvicorn agent_fastapi:app
  4. 创建 session 并发送剪辑请求。
  5. 等待并验证输出视频产物。
  6. 在同一个 session_id 上继续对话,执行二次编辑。
  7. 验证二次编辑后是否生成了新的 output_*.mp4

不处理完整安装流程(依赖安装、模型下载、资源下载等),那是安装技能的范围。如果在启动时遇到问题,怀疑是安装问题,再去查看安装Skill openstoryline-install

Core Rules

  1. 默认只监听 127.0.0.1,不要主动暴露到局域网。
  2. 优先复用现有脚本,不要重复造轮子:
    • 修改配置脚本:位于代码仓库scripts/update_config.py
    • Web 服务桥接脚本位于当前 skill 目录下的 scripts/bridge_openstoryline.py。请先定位当前 skill 目录,再拼接scripts/bridge_openstoryline.py
  3. 长驻服务(MCP / Web)必须按“长驻进程”方式启动,并持续观察日志;不要把启动命令当成一次性探测命令。
  4. 不要在启动命令后面追加这些包装:
    • | head
    • | tail
    • grep
    • timeout
    • sleep
    • pkill
    • 以及其它会截断日志、提前退出、强行杀进程的包装
  5. 询问用户需要剪辑哪些素材及其路径。
  6. 第一轮创建 session 后返回的 session_id 必须保存;后续继续对话、二次编辑都依赖它。
  7. 如果服务端提示“上一条消息尚未完成,请稍后再发送”,不要新建 session;优先等待,必要时只终止卡住的本地 bridge 进程,然后继续复用原 session_id 重试。
  8. 不要在任务执行中途主动终止 MCP / Web 服务,除非用户明确要求停止,或者服务本身已经确认失活。
  9. 每次完成任务后,都要向用户明确返回:
    • session_id
    • 最终视频 .mp4 的完整路径
    • 如有二次编辑,还要说明是否生成了新的输出文件
  10. 下面的示例命令都使用source .venv/bin/activate作为示例,你需要根据用户实际使用的环境,替换成正确的命令(例如conda activate )。
  11. 遇到端口被占用的情况,优先换一个端口。

OpenClaw Execution Strategy (Important)

如果你是OpenClaw,一定注意以下关键点:

长驻服务怎么跑

对于以下两类命令:

  • PYTHONPATH=src python -m open_storyline.mcp.server
  • uvicorn agent_fastapi:app --host 127.0.0.1 --port 8005

必须按“长驻进程”处理:

  1. exec 启动,并开启 PTY(如果工具支持 pty: true,就开启)。
  2. 启动后不要立刻判失败,MCP Server启动需要几分钟的时间。
  3. process poll / process log 持续观察返回的内容,一定不要急着杀掉进程。
  4. 看到成功日志再继续下一步。

一次性命令怎么跑

以下命令适合普通一次性 exec

  • 修改 config.toml
  • 创建 session
  • 在现有 session_id 上继续对话
  • 查找 .mp4
  • 查看文件大小

观察哪个日志最有用

实测中,Web 服务日志 最适合看剪辑进度。
常见正常流程节点包括:

  • filter_clips
  • group_clips
  • generate_script
  • generate_voiceover
  • render_video

Read the full file on GitHub · 337 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 337 lines · 80 tokens per session scan A 039576d90fae

Subscribe to this mod's changes

openstoryline-use is a skill published in the GitHub repository FireRedTeam/FireRed-OpenStoryline (3,389 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 80 tokens to every session and 3,677 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

wegent-video-generation

Use this skill when the user asks to generate or create a video. Supports text, image, video, and audio reference materials according to the selected video model.

wecode-ai/Wegent · 32 tokens

pireel

Edit videos in Pireel Studio through the pireel MCP server — first-run setup, local and stock media import, transcript editing, multi-source montage, multiple editable outputs, storyboarding, designed graphics, captions, themes and export. Read this whenever the user wants to install/connect Pireel or edit, cut…

pireel/pireel-agent · 111 tokens

video-cut

Edit raw footage into a finished cut by conversation, fully local. Drop clips in a folder, describe the video you want, get edit/final.mp4 back. Local-first raw-footage video editor — the editorial counterpart to the generative Remotion/launch-video skills. Uses a two-layer reading system (local fasterwhisper…

broomva/skills · 294 tokens

officecli-pitch-deck

Use this skill when the user is building a fundraising / investor pitch deck — seed, Series A / B / C, convertible note, SAFE round, strategic raise. Trigger on: 'pitch deck', 'investor deck', 'Series A deck', 'Series B deck', 'Series C deck', 'fundraising deck', 'seed pitch', 'VC deck', 'raising capital', 'term sheet…

iOfficeAI/OfficeCLI · 163 tokens

morph-ppt

Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style continuous motion, shapes that grow / move / rotate as the slide advances. Trigger on: 'morph', 'morph transition', 'smooth transition', 'continuous animation across slides', 'Keynote-style…

iOfficeAI/OfficeCLI · 169 tokens

morph-ppt-3d

3D Morph PPT — extends morph-ppt with GLB model insertion, cinematographic camera, model-content layout, and enriched visual design system.

iOfficeAI/OfficeCLI · 37 tokens