Communitygithub.com

ws-cczj/article-video-skill

Turn academic papers into learning videos by first producing a Chinese academic-style summary, then narration, visual planning, storyboards, and video review. Render videos when suitable tools are available. Use for paper-to-video learning summaries.

What is article-video-skill?

article-video-skill is a Claude Code agent skill that turn academic papers into learning videos by first producing a Chinese academic-style summary, then narration, visual planning, storyboards, and video review. Render videos when suitable tools are available. Use for paper-to-video learning summaries.

Works with~Claude Code~Codex CLI~Cursor
npx skills add ws-cczj/article-video-skill

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

文献转学习视频

将论文的研究问题、方法、证据和局限组织成适合学习的视频讲解。先交付中文论文式总结,再改写旁白、选择视觉方案和组织分镜,最后制作并审查视频。最终视频取决于环境中实际可用的工具。

输入与范围

  • 接受论文文件、可访问链接或用户提供的正文。先确认实际读到了哪些部分;仅有摘要时,不据此声称已阅读或总结全文。
  • 无论原文为中文或英文,文献总结的正文、摘要、章节说明和图表说明均使用中文;保留原论文标题、作者、可核验引用、公式、变量和必要英文术语。视频语言另按用户要求确定,不能因此改变中文总结的默认要求。
  • 从用户要求确定受众、视频语言、时长、画幅与输出位置。未指定时,以本科生、中文、约 5 分钟、16:9 为初始假设,并在交付中说明。
  • 阅读输入与规划脚本可以直接进行。缺少正文等影响事实依据的材料时,请求补充;仍可先整理已有内容并标明范围。

从证据到中文论文式总结

  1. 创建独立输出目录。复制 证据模板 为 evidence.md,记录论文元数据和访问范围。
  2. 读出研究问题、已有工作的不足、方法、实验条件、关键结果和局限。每个核心事实记录页码、章节、公式或图表编号;区分论文结论、助手解释与待核实项。
  3. 检查数值及其单位、比较基线、数据集和适用条件。不得把相关性改写成因果,也不得把局部实验推广为普遍结论。
  4. 阅读 中文总结与排版规范,生成独立的 summary.md,不能以要点表或旁白代替中文总结。按论文式结构组织正文;对于理论、综述等类型调整方法和结果章节,不补造不存在的实验。
  5. 使用 中文论文排版模板 生成与总结正文一致的 summary.tex。用户已有院校或期刊模板时优先遵循;未提供时使用项目默认排版,不将其宣称为统一学术标准。
  6. 核查翻译、公式、上下标、符号、单位、引用和事实依据。有可用编译器时生成 summary.pdf 并检查实际页面;没有编译器时交付正文与源稿,明确 PDF 未生成、页面排版未验收。公式无法辨认时标明待核实,不能猜写。
  7. 中文总结完成事实核对后,才以它为依据编写视频旁白;页面排版尚未验收时保留该待办,不得将整个总结交付宣称为排版验收完成。不要求用户在每个阶段批准,除非用户明确提出。

从中文总结到旁白与分镜

  1. 从 summary.md 提取适合受众和时长的故事线,改写为可朗读的完整句子。不得直接把论文式总结整篇配音。首次出现术语时解释;默认每分钟约 220–280 个中文字用于初估,最终以实际配音时长为准。
  2. 复制 分镜模板 为 storyboard.md,关联总结章节与证据编号。按“问题—核心思路—方法—结果—局限—复习”组织内容,可按论文调整顺序和比重。
  3. 依据内容确定视觉方案:整片统一字体、配色、字幕和转场;镜头按需要选用概念解释、方法流程、实验对比、数据展示或公式推演。记录选用理由、实际模板或实现方式;没有现成渲染模板时明确为视觉设计方案,不声称模板库已可用。
  4. 分镜逐项写清时间、学习目标、画面、旁白、字幕和引用。数值图表应来自原文可核验数据;自行绘制的概念图或动画注明“示意”,不要伪装为实验结果。
  5. 结尾设置 2–3 个复习问题或要点,帮助学习者回忆方法、证据与限制。

视频制作与交付

  • 先检查是否已有可用的文档提取、TTS、字幕对齐和视频渲染工具。尊重用户指定的工具与素材;本 Skill 不自带这些程序。
  • 工具不足时仍先交付中文总结及排版源稿,再交付证据记录、完整旁白及分镜;说明 PDF 与视频各自的实际生成状态及缺少的能力,不输出空白视频或虚构文件链接。
  • 使用现有可用工具合成语音、生成字幕并渲染画面。需要安装大型依赖或使用收费服务时,先说明具体依赖或费用并获得相应授权。
  • 字幕时间轴应匹配实际音频;渲染完成后检查总时长、音轨、字幕同步、中文字体、画面裁切、图表可读性及来源标注。
  • 对照证据记录复核最终脚本与视频中的核心结论和数值;不能验证的内容删去或明确标注。
  • 审查实际渲染的视频,不能只审查脚本或静态封面。将内容准确性、学习效果、审美一致性和视听同步的问题写入 review.md,包含时间点、镜头编号、问题、修改建议及复查结果。根据问题局部微调,复查修改镜头与前后衔接;重大内容变更后通看全片。
  • 无法播放或分析实际视频时,列明已做的检查、未做的检查及原因,不声称已完成全片审查。准确性、可读性或同步问题尚未解决时,标记为待修改,不宣称合格。
  • 交付实际生成的文件路径、覆盖的原文范围、采用的假设和未完成项。仅在文件存在且已检查后声明视频完成。

素材与来源

引用论文标题、作者、年份和可核验的 DOI 或来源链接。公开示例仅使用允许再分发的材料;不得将用户提供的非公开文献或生成视频自动上传到仓库或其他平台。

Related Skills