video-note

Q: How do I install video-note?

Run npx skills add https://github.com/joelhooks/joelclaw --skill video-note in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/video-note/ (personal) or .claude/skills/video-note/ (project).

by joelhooksMedia & Creative

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.

Installs: 52
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/joelhooks/joelclaw --skill video-note

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads video-note automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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.

FAQ

What does the video-note skill do?

How do I install video-note?

Run npx skills add https://github.com/joelhooks/joelclaw --skill video-note in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/video-note/ (personal) or .claude/skills/video-note/ (project).

Which AI agents can use video-note?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is video-note safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains video-note?

It is published by joelhooks in joelhooks/joelclaw. It has 52 recorded installs.

More from joelhooks/joelclaw

View all →

contacts

joelhooks/joelclaw

Add, enrich, and manage contacts in Joel's Vault. Fire the Inngest enrichment pipeline for full multi-source dossiers, or create quick contacts manually. Use when: 'add a contact', 'enrich this person', 'who is X', 'VIP contact', 'update contact', or any task involving the Vault/Contacts directory.

Productivity & Automation3.3K installs