ray-kb

Convert verified long-form articles into shootable Chinese oral-video script packages.

160|18|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/imraywang/rayskills --skill ray-kb-imraywang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ray-kb
Source: https://github.com/imraywang/rayskills/tree/main/skills/ray-kb
Command: npx skills add https://github.com/imraywang/rayskills --skill ray-kb-imraywang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Repurposing a finished long-form article into a spoken video script usually means either a lazy summary or accidental fabrication of facts. This Skill re-selects a single video angle from a verified master draft and produces a complete, record-ready oral content package while keeping the master draft as the sole source of truth. ## Core Features & Use Cases - Angle Selection: Extracts up to three candidate video angles from the master draft, then commits to one central judgment with one opening hook and one closing action. - Record-Ready Package: Outputs a topic card, three opening options, a verbatim script, shooting rhythm table, asset checklist, image-card interface, and pre-recording verification section. - Source Integrity Validation: Binds the derivative script to the master draft via source_draft and source_sha256, and validates structure, duration estimates, and banned filler phrases with oral_script_check.py. - Use Case: You have a finalized 4000-character article and want a 2-3 minute talking-head video with screen recording. The Skill picks one judgment, writes a speakable script, plans shots, and hands off B-roll needs to a downstream skill without altering facts. ## Quick Start Use ray-kb to turn my finalized article into a 2-3 minute spoken video script package with shooting rhythm and a pre-recording checklist.

Frequently Asked Questions about ray-kb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a long article into a short video script?▼

Provide the finalized article and the Skill selects one central judgment suitable for video, then produces a verbatim script, shooting rhythm table, and asset checklist. It restructures the content around a single hook and one closing action rather than summarizing every section.

What is the best way to repurpose blog content for video?▼

Choose one judgment that survives without tool names, open with a conflict in the first 8-10 seconds, and let each visual prove one spoken line. This Skill enforces that structure and validates the result with oral_script_check.py before recording.

Can I use a content-pack or research note as the video source?▼

No. The Skill only accepts full drafts or published articles as the master source. If given a content-pack, it follows the draft link in the frontmatter to find the complete article, and stops with a clear gap report if none exists.

Does the script validation check actual recording duration?▼

No. oral_script_check.py estimates duration from Chinese character counts at 220-260 characters per minute and verifies structure, source fingerprints, and banned phrases. A real read-through is still required to confirm actual timing.

What are the limitations of automated article-to-video adaptation?▼

The Skill cannot add facts beyond the master draft, will not write first-person claims the user has not verified, and does not publish or generate final image cards. B-roll generation and live filming are handed off to separate steps.