sample_writer - Minimal Video Script Writing Assistant
This is a simplified skill for generating long-form document/book commentary video scripts. It merges the reading, writing, and polishing processes to help you quickly produce conversational, engaging Chinese scripts for Video Account (WeChat Channels) and Douyin.
Target Word Count Configuration
This configuration is the single source of truth for the final word count of the main body in this skill.
draft_min_chars: 1000 # Minimum word count for first draft final_target_chars: 1200 # Target word count for final draft
Main Workflow
You only need to follow these three core steps; no need to keep complex override logs. Please save any intermediate outputs during the process in the working directory (text folder of the project output):
-
Quick Reading & Organizing:
- Quickly browse the core content of the input file (focus on the beginning, table of contents, core chapters, and conclusion).
- Extract one core question that the entire book truly attempts to answer, the author's core answer framework, and 3 key cases or arguments.
- Save the above extracted outline as an intermediate product to
_extract.txt.
-
First Draft Writing (Conversational):
- Following the guidelines in
references/writing_guide.md, write a first draft that is well-structured, plain-spoken, and suitable for direct oral delivery, meeting thedraft_min_charsword count. - Save the first draft as an intermediate product to
_draft_v1.txt.
- Following the guidelines in
-
Self-Check & Final Packaging:
- Perform self-correction to remove unnecessary filler words, written-language pitfalls, and "AI-sounding" vocabulary, and save the corrected final draft to
_draft_final.txt. - Generate titles, cover copy, golden quotes, interaction prompts, and sharing prompts from
_draft_final.txt, and package everything into the final JSON, writing it to{output_json}. - Ensure the output
{output_json}can be parsed by Pythonjson.loadsand fully conforms to the JSON output contract below.
- Perform self-correction to remove unnecessary filler words, written-language pitfalls, and "AI-sounding" vocabulary, and save the corrected final draft to
Final JSON Output Contract
Output only a strict JSON object, without any Markdown markers or extra explanation.
{
"source_name": "Work name (e.g., The Selfish Gene), without file extension",
"video_titles": ["3 candidate video titles, non-repeating, complete information"],
"cover_titles": ["3 main cover titles, 4 to 10 characters, short, strong, easy to scan"],
"cover_subtitles": ["3 cover subtitles, within 15 characters"],
"golden_quotes": ["3 opening golden quotes, strong opinion, attention-grabbing"],
"comment_hook_options": ["3 comment prompts, prefer judgment sentences, contrast sentences, or follow-up questions; not marketing jargon"],
"share_hook_options": ["3 sharing prompts that sound like something viewers would naturally share after watching"],
"content": "Complete spoken final draft, around final_target_chars word count, preserving natural paragraph breaks, no Markdown markers or subtitles",
"total_length": 0
}
total_lengthis the actual character count ofcontent.contentmust be completely conversational, preserve natural paragraph breaks, and absolutely must not contain subtitles, Markdown, or list formatting.