Video Note Writer

Video Note Writer

Overview

Turn evidence into a tutorial-style Markdown note, not just a plain summary. The target output is a titled Markdown study note with clear structure, simple explanations, chapter images, optional formulas or tables, and explicit separation between "video said this" and "external expansion".

Workflow

1. Read all input artifacts first:
   • video title and URL
   • sectioned.md
   • subtitles.json or another raw subtitle file
   • keyframe images and timestamps, if already provided
   • optional web search results
2. Determine the exact video title and use it as the output filename stem. Display name stays as the true video title even if the filesystem filename must be sanitized.
3. Build an evidence map before drafting:
   • subtitle evidence
   • keyframe evidence
   • external-source evidence
   • unresolved items
4. If chapter keyframes are missing or insufficient, note the gap before drafting. For each chapter, choose one main timestamp that best represents the teaching point of that section. If formulas, tables, diagrams, maps, or slides appear, optionally choose one additional figure timestamp for that chapter.
5. Consume frame artifacts that already exist. If a chapter is missing a useful screenshot, continue writing the note and leave an image placeholder or omit the image line.
6. Draft the note in tutorial layers:
   • what the video is saying
   • what that means in simple language
   • why it matters
   • how a beginner should understand it
   • what to be careful not to misunderstand
7. Only use web research when you need:
   • extra background knowledge
   • formula verification
   • table completion
   • terminology clarification
   • fact checking
8. Keep "video content" and "external expansion" separate. External facts must never be presented as if they were said in the video.
9. If formulas or tables appear, write them in Markdown only when they are reliable. If they are incomplete or ambiguous, mark them as pending-review.
10. Run a final multi-check pass:

• factual consistency
• chapter/image alignment
• image evidence quality
• formula/table reliability
• source boundary
• tutorial clarity
• Markdown rendering safety

If the required evidence artifacts are missing, stop and call the evidence layer first instead of inventing content.

Hard Rules

• Output one Markdown file body unless the user explicitly asks for extra artifacts.
• Default filename rule: use the video title as the file stem and apply the note suffix shown in the output template reference.
• Prioritize clarity over polish.
• Use short paragraphs, short sentences, and direct explanations.
• Avoid unexplained jargon. If a term is necessary, explain it the first time it appears.
• Every important conclusion should be attributable to subtitles, keyframes, external sources, or be explicitly marked as uncertain.
• Do not invent formulas, tables, dates, names, values, or causal explanations.
• If extra knowledge is added, make it obvious that it is external expansion.
• If image paths are provided or generated by the evidence layer, use standard Markdown image syntax.
• Prefer one main image per chapter, placed directly under the chapter heading.
• If a formula/table/diagram needs its own image, place that image inside the "Formula and Table" or equivalent visual subsection, not at random.
• If formulas are used, use $...$ or $$...$$.
• If tables are used, use standard Markdown tables.
• Do not silently fetch subtitles or screenshots from the source platform inside this skill. Consume existing artifacts or clearly state that evidence is missing.

Teaching Bias

When the evidence allows it, prefer notes that feel like a beginner tutorial:

• start each chapter with "what this section is teaching"
• explain "why it matters"
• give a plain-language version
• if possible, add one intuitive example or analogy
• point out one common misunderstanding or likely confusion point

Do not force examples or analogies when the evidence is too weak.

References

• Read references/prompt-blueprint.md for the recommended master prompt.
• Read references/output-template.md for the target note structure.
• Read references/keyframe-selection.md for how to pick and place screenshots.
• Read references/verification-checklist.md for the final multi-check pass.