mcpField
V
video-note

video-note

github.com/joelhooks生産性6552 回インストール2 日前に更新
リポジトリ

video-note について

video-noteは、Obsidianの動画ノートをjoelclaw.com向けのMDXコンテンツに変換する公開用スキルです。サイトのコンテンツを管理する人向けに、素材の選定、書き換え、書式設定、命名の手順を定めています。

主な機能

  1. 01Obsidianの動画ノートを読み込み
  2. 02サイト用MDX形式に変換
  3. 03YouTube動画の抽出と埋め込み
  4. 04公開向け素材の選定と編集
  5. 05Obsidian記法の整理とslug作成

活用シーン

  1. 01動画ノートをサイトで公開
  2. 02wikilinksをMarkdownリンクに変換
  3. 03引用、話者情報、関連リンクの整理

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/video-noteを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

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

詳細

動画ノートの公開

/Users/joel/Vault/Resources/videos/ にある動画ノートを、joelclaw.com サイトの apps/web/content/ に公開する MDX ノートへ変換します。

ソース形式

Vault の動画ノートは、次のフロントマターを含む Obsidian Markdown です。

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

本文には、H1 タイトル、> [!info] Source コールアウト、Executive Summary、Key Points、Speaker Context、Notable Quotes、Related links、Tags、折りたたみ可能な Full Transcript が含まれます。

出力形式

apps/web/content/ に .mdx として公開し、次のフロントマターを使用します。

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"

変換ワークフロー

  1. ソース Vault のノートを読みます
  2. source URL から YouTube 動画 ID を抽出します
  3. Joel の文体でノートを書きます（同じ .agents/skills/ ディレクトリにある joel-writing-style スキルを読みます）。主なルール：
    • 要約ではなく、読者を引き込む書き出しにします
    • 関連する場合は Joel が提供した切り口を使い、Joel の経験、信念、個人的な反応を決して作り上げないでください
    • 短い段落を使い、効果的に罵り言葉を使い、強調には太字を使います
    • 無理なまとめはせず、唐突に終えます
  4. 導入の後に <YouTube id="VIDEO_ID" /> を埋め込みます
  5. 公開する読者に適した、ソースで裏付けられた内容を選びます。全文書き起こし、非公開の文脈、顧客情報、有料コーパスの内容は除外します。そのうえで、関連するセクションを次のように調整します：
    • Executive summary → Joel の文体で書き直し、導入として使います
    • Key points → 内容は維持し、文章を引き締めます
    • Speaker context → 「[Speaker] について」セクションにします
    • Notable quotes → 厳選した「印象に残った引用」にします
    • Related links → 「Related」セクションとして残します
  6. Obsidian の構文を取り除きます：> [!info] コールアウト → プレーンテキスト、[[wikilinks]] → Markdown リンク
  7. スラッグ：簡潔なケバブケース（例：openclaw-peter-steinberger-lex-fridman）

文体の参考資料

Joel の文体の詳細については、joel-writing-style SKILL.md と文体の例を読んでください。主なポイント：

  • 一人称を使うのは、Joel が実際に述べた言葉や、提供された経験に限ります。役立つ場合は、読者に直接語りかけます。
  • 常に短縮形を使います
  • キーフレーズのインライン強調には太字を使います
  • 絵文字は控えめに使います（ノートあたり最大 1～2 個）
  • 見出しは概要ではなく、物語の展開を刻むものにします
  • リンクは文の中に自然に織り込み、「ここをクリック」は使いません
  • 人物には名前を記し、リンクを付けます

コンテンツシステムの詳細

joelclaw.com のコンテンツタイプ、MDX コンポーネント、ルーティングについては、content-system.md を参照してください。

例

目標とする形式と文体を示す、公開済みノートの完全な例については、example-note.md を参照してください。

コメント

Markdown 対応