mcpField
V
video-note

video-note

github.com/joelhooksProductivity6552 installsUpdated 2d ago
Repository

About video-note

video-note is a publishing skill for turning Obsidian video notes into MDX content for joelclaw.com. It is intended for people maintaining the site and defines the content selection, rewrite, formatting, and naming workflow.

Key features

  1. 01Read Obsidian video notes
  2. 02Convert notes to site MDX format
  3. 03Extract and embed YouTube videos
  4. 04Select and adapt publication-ready material
  5. 05Clean Obsidian syntax and create slugs

Use cases

  1. 01Publish video notes on the website
  2. 02Convert wikilinks to Markdown links
  3. 03Organize quotes, speaker context, and related links

Install

Copy the command and run it in a terminal.

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

After installing, type/video-notein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
assets/
small-logo.svg
references/
content-system.md
example-note.md

Details

From the project README

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

  1. Read the source vault note
  2. Extract YouTube video ID from the source URL
  3. 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
  4. Embed the video with <YouTube id="VIDEO_ID" /> after the intro
  5. 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
  6. Strip Obsidian syntax: > [!info] callouts → plain text, [[wikilinks]] → markdown links
  7. 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.

Comments

Markdown supported