Video Note Publishing
Transform video notes from /Users/joel/Vault/Resources/videos/ into published MDX notes on the joelclaw.com site at apps/web/content/.
Source format
Vault video notes are Obsidian markdown with this frontmatter:
type: video
source: https://www.youtube.com/watch?v=ID
channel: Channel Name
published: YYYY-MM-DD
duration: "HH:MM:SS"
nas_path: /volume1/home/joel/video/...
transcribed: YYYY-MM-DD
tags:
- videoBody contains: H1 title, > [!info] Source callout, Executive Summary, Key Points, Speaker Context, Notable Quotes, Related links, Tags, and a collapsible Full Transcript.
Output format
Publish as .mdx in apps/web/content/ with this frontmatter:
title: "Short descriptive title"
type: "note"
date: "YYYY-MM-DD" # use today's date
description: "One-sentence hook in Joel's voice"
source: "YouTube URL"
channel: "Channel Name"
duration: "HH:MM:SS"Transformation workflow
- Read the source vault note
- Extract YouTube video ID from the
sourceURL - Write the note in Joel's voice (read
joel-writing-styleskill — it's in the same.agents/skills/directory). Key rules:
- Open with a hook, not a summary - Add a personal "why this matters to me" frame connecting the video to JoelClaw - Use short paragraphs, strategic profanity, bold for emphasis - End abruptly — no forced wrap-up
- Embed the video with
<YouTube id="VIDEO_ID" />after the intro - Include everything from the vault note except the full transcript:
- Executive summary → rewrite as the intro (Joel's voice) - Key points → keep substance, tighten prose - Speaker context → "Who is [Speaker]" section - Notable quotes → curated "Quotes that stuck with me" - Related links → keep as "Related" section
- Strip Obsidian syntax:
> [!info]callouts → plain text,[[wikilinks]]→ markdown links - Slug: kebab-case, concise (e.g.,
openclaw-peter-steinberger-lex-fridman)
Voice reference
For Joel's writing style details, read joel-writing-style SKILL.md and its voice examples. Key points:
- Conversational first person, address reader as "you"
- Contractions always
- Bold for inline emphasis on key phrases
- Emoji sparingly (1-2 per note max)
- Headers as narrative beats, not outlines
- Links woven into sentences, never "click here"
- Credit people by name with links
Content system details
See content-system.md for the joelclaw.com content types, MDX components, and routing.
Example
See example-note.md for a complete published note showing the target format and voice.