跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

papercut-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

0xS4N4TG · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add 0xS4N4TG/papercut-explainer --skill papercut-explainer

技能说明


name: papercut-explainer description: Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

Papercut Explainer

A ~20-45 s vertical explainer that looks like layered construction paper brought to life: grainy paper props with drop shadows, rigid cut-out animation, a slow camera push with stop-motion paper boil, a taped headline banner per beat and word-by-word torn-paper caption tags. Built with Remotion, optional AI-generated textured assets, and any TTS.

Every beat runs three tracks:

  • the voiceover tells the story
  • the taped banner adds a hard fact the voiceover skips
  • a fresh paper set illustrates the voiceover's words, with a rough papercut rebuild of the product UI doing the demo

Reuse the style and the storytelling, not the worked examples' content. Every product, company and number in the examples is invented. The style rules are in references/style-guide.md (section 2 is the Style DNA).

Preflight

  • Library. Resolve $PAPERCUT_LIB, else the PAPERCUT_LIB= line in ${XDG_CONFIG_HOME:-~/.config}/papercut-explainer/config.env, else ask once. Never hard-code a machine path. Stages 1 to 4 need no library.
  • Install mode. Probe it before promising a stage (see Install modes below).
  • Series. Find the series folder (it holds episodes/). Read its SERIES.md if it exists.

Run modes (ask first)

  1. Full reel, idea to mp4: stages 1 to 8, then stage 9 after posting.
  2. Script only: strategy, hook, script (stop after the staging table).
  3. Storyboard from an existing script: papercut-storyboard. Ask for the script, the facts and the HOOK block.
  4. Style prompt for another tool: give the right block from references/style-prompt.md and stop.
  5. Fix or rebuild one scene: papercut-build (scenes step), then papercut-qa.

Intake (ask only what is missing)

  • Source: usually a link (repo, product site, announcement). Everything else is researched from it.
  • The one claim the video proves, and the topic.
  • Role framing: who or what does the work, who advises or approves. Confirm it with the user and never invent product behaviour.
  • CTA keyword and what the viewer gets (the deliverable).
  • Length: default 22-30 s.
  • Audience level (from SERIES.md) and any accent colour or mascot.

Write the answers as the BRIEF block at the top of episodes/NN-slug/research/facts.md (format in papercut-strategy).

Stages

#StageSkillReadsWrites
1Strategypapercut-strategySERIES.md, the sourceBRIEF in research/facts.md, SERIES.md
2Hookpapercut-hookBRIEFHOOK block at the top of papercut/STORYBOARD.md
3Scriptpapercut-scriptBRIEF, HOOKresearch/facts.md, narration/script.json, staging table in STORYBOARD.md
4Storyboardpapercut-storyboardscript.json, STORYBOARD.mdCamera/Cut table, scene blocks, SFX plan in STORYBOARD.md
5Scaffold and planpapercut-buildSTORYBOARD.mdthe project, episode.json
6Voice and timingpapercut-voicescript.json, voice/voice.jsonnarration/ takes, public/vo/captions.json, src/plan.json
7Scenes, sound, renderpapercut-buildplan.json, STORYBOARD.mdsrc/scenes/*, tools/cues.json, out/*.mp4
8QApapercut-qastills, STORYBOARD.mdfixes, the delivery summary
9After postingpapercut-strategy (autopsy), papercut-build (harvest)platform numbers, the projectresearch/analytics/, library promotions

Project files

The pipeline lives in files, not in chat. Each stage reads the files above and writes its own, so a new session can resume from any stage.

<series>/
  SERIES.md                  optional: audience, voice, palette, mascot, keyword log
  voice/voice.json           optional: voice settings (copy library/voice/voice.example.json)
  papercut-assets/           optional: overlay textures and props
  research/analytics/        optional: competitor studies and autopsies
  episodes/NN-slug/
    research/facts.md        BRIEF + facts with sources
    narration/script.json    [{"id": "l1_hook", "text": "..."}, ...]
    papercut/
      episode.json           scenes, banners, hook, gaps, bed, cuts
      STORYBOARD.md          HOOK, staging table, Camera/Cut table, scene blocks

Library catalogs: library/papercut/CATALOG.md (every kit component) and library/audio/CATALOG.md (every SFX and bed). They are generated, so a fresh checkout may lack them or have stale ones. Run python3 $PAPERCUT_LIB/tools/catalog.py to rebuild. Agents read the catalogs, not the kit source.

Reuse before writing: a kit component, a props set or a scene template beats new drawing code. Pick SFX and beds by name.

Install modes

  • Minimal (skills only): strategy, hook, script, storyboard, style prompts. No rendering.
  • Standard: Minimal + build and render with a placeholder voice (silent, or macOS say) via library/tools/placeholder_vo.py, stills QA, SFX and bed audio, the full mp4.
  • Full: Standard + local Qwen3-TTS voiceover and word-timed captions from real audio.

Probe (read-only):

. "$(grep '^PAPERCUT_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/papercut-explainer/config.env" | cut -d= -f2-)/env.sh"   # fills PAPERCUT_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$PAPERCUT_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'

The first three lines passing means Standard. The qwen_tts import passing as well means Full. If a stage needs more than the install provides, say so in one line, run ./install.sh --doctor from the repo root, and hand over to papercut-setup instead of improvising. Find the root with readlink on the installed sk

阅读完整来源 ↗