video-note
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.
How do I install this agent skill?
npx skills add https://github.com/joelhooks/joelclaw --skill video-noteIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates the transformation of local Obsidian video notes into published MDX files for a personal website. It accesses sensitive user directories and is susceptible to indirect prompt injection from the processed note content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1/4 files flagged
What does this agent skill do?
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
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
- 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/joelhooks/joelclaw/video-note">View video-note on skillZs</a>