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:
- video
Body 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
source URL
- Write the note in Joel's voice (read
joel-writing-style skill — it's in the same .agents/skills/ directory). Key rules:
- Open with a hook, not a summary
- Use Joel’s supplied framing where relevant; never invent his experience, beliefs, or personal reaction
- 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
- Select source-supported material appropriate for the publication audience. Exclude the full transcript, private context, customer information, and paid corpus material. Then adapt relevant sections:
- 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:
- Use first person only for Joel’s documented words or supplied experience. Address the reader directly when useful.
- 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.
1---
2name: video-note
3displayName: Video Note
4description: "Transform Obsidian video notes from the Vault into published notes on joelclaw.com. Use when publishing video notes, converting vault video content to the site, or when asked to 'publish a video note,' 'turn this video into a note,' 'publish from vault/videos,' or any task involving /Vault/Resources/videos → joelclaw content. Triggers on references to video notes, vault video files, or publishing video content to the blog."
5version: 1.0.0
6author: Joel Hooks
7tags: [joelclaw, video, notes, publishing, obsidian]
8---
9
10# Video Note Publishing
11
12Transform video notes from `/Users/joel/Vault/Resources/videos/` into published MDX notes on the joelclaw.com site at `apps/web/content/`.
13
14## Source format
15
16Vault video notes are Obsidian markdown with this frontmatter:
17
18```yaml
19type: video
20source: https://www.youtube.com/watch?v=ID
21channel: Channel Name
22published: YYYY-MM-DD
23duration: "HH:MM:SS"
24nas_path: /volume1/home/joel/video/...
25transcribed: YYYY-MM-DD
26tags:
27 - video
28```
29
30Body contains: H1 title, `> [!info] Source` callout, Executive Summary, Key Points, Speaker Context, Notable Quotes, Related links, Tags, and a collapsible Full Transcript.
31
32## Output format
33
34Publish as `.mdx` in `apps/web/content/` with this frontmatter:
35
36```yaml
37title: "Short descriptive title"
38type: "note"
39date: "YYYY-MM-DD" # use today's date
40description: "One-sentence hook in Joel's voice"
41source: "YouTube URL"
42channel: "Channel Name"
43duration: "HH:MM:SS"
44```
45
46## Transformation workflow
47
481. Read the source vault note
492. Extract YouTube video ID from the `source` URL
503. Write the note in Joel's voice (read `joel-writing-style` skill — it's in the same `.agents/skills/` directory). Key rules:
51 - Open with a hook, not a summary
52 - Use Joel’s supplied framing where relevant; never invent his experience, beliefs, or personal reaction
53 - Use short paragraphs, strategic profanity, bold for emphasis
54 - End abruptly — no forced wrap-up
554. Embed the video with `<YouTube id="VIDEO_ID" />` after the intro
565. Select source-supported material appropriate for the publication audience. Exclude the full transcript, private context, customer information, and paid corpus material. Then adapt relevant sections:
57 - Executive summary → rewrite as the intro (Joel's voice)
58 - Key points → keep substance, tighten prose
59 - Speaker context → "Who is [Speaker]" section
60 - Notable quotes → curated "Quotes that stuck with me"
61 - Related links → keep as "Related" section
626. Strip Obsidian syntax: `> [!info]` callouts → plain text, `[[wikilinks]]` → markdown links
637. Slug: kebab-case, concise (e.g., `openclaw-peter-steinberger-lex-fridman`)
64
65## Voice reference
66
67For Joel's writing style details, read [joel-writing-style SKILL.md](../joel-writing-style/SKILL.md) and its [voice examples](../joel-writing-style/references/voice-examples.md). Key points:
68
69- Use first person only for Joel’s documented words or supplied experience. Address the reader directly when useful.
70- Contractions always
71- Bold for inline emphasis on key phrases
72- Emoji sparingly (1-2 per note max)
73- Headers as narrative beats, not outlines
74- Links woven into sentences, never "click here"
75- Credit people by name with links
76
77## Content system details
78
79See [content-system.md](references/content-system.md) for the joelclaw.com content types, MDX components, and routing.
80
81## Example
82
83See [example-note.md](references/example-note.md) for a complete published note showing the target format and voice.