YouTube → Lokus

{
  "name": "yt-lokus",
  "description": "Turns a YouTube video into a Markdown note for Lokus: metadata, summary, critical review and a clickable timestamped transcript.",
  "version": "0.2.0",
  "author": {
    "name": "bendevcat"
  },
  "homepage": "https://github.com/bendevcat/yt-lokus",
  "license": "MIT",
  "keywords": [
    "youtube",
    "transcript",
    "transcription",
    "lokus",
    "notes",
    "yt-dlp"

#!/usr/bin/env python3
"""Tools for Lokus notes.

    lokus_tools.py find <video_id> <root>   notes that already mention this video
    lokus_tools.py tags <root>              tags in use, most frequent first
    lokus_tools.py check <note.md>          checks a finished note (exit 1 on error)

French and English notes are both understood.
"""
import collections
import os
import re
import sys
from pathlib import Path

TRANSCRIPT_HEADING = re.compile(r"^## (?:Transcription|Transcript)$", re.MULTILINE)

#!/usr/bin/env python3
"""Turns YouTube subtitles fetched by yt-dlp into a Markdown note for Lokus.

    to_lokus.py <video.info.json> <video.LANG.json3> <output_dir> [note_lang]

Both files come from yt-dlp (--write-info-json --write-subs --write-auto-subs
--sub-format json3). note_lang sets the language of the note's labels: `fr` or
`en` (default), any other value falls back to English.

Writes <output_dir>/<title>.md and prints its path. An existing file is never
overwritten (suffix -2, -3…). The summary and review sections hold the markers
<!-- RESUME --> and <!-- AVIS -->, which Claude then replaces.
"""
import json
import re
import sys

---
name: yt-lokus
description: Transcribes a YouTube video and saves it as a formatted Markdown note (metadata, summary, critical review, clickable timestamped transcript) in a Lokus notes folder. Use whenever the user gives a YouTube link and asks for a transcript, to "transcribe" it, to "save it to Lokus" (« l'enregistrer dans Lokus »), to summarize a video to keep it (« résumer une vidéo pour la garder »), or types /yt-lokus <url>. Free, via yt-dlp.
---

# YouTube → Lokus

Fetches the YouTube subtitles, formats them with `scripts/to_lokus.py`, then adds
a summary and a review. `scripts/lokus_tools.py` handles the checks.

Paths and values used below:
- `<skill>`: this skill's folder, given when it is loaded;
- `<notes>`: the root of the Lokus notes, read from the `YT_LOKUS_NOTES` variable.
  Empty variable → ask the user for the path, and offer to set it in the `env`
  block of `~/.claude/settings.json`;
- `<output>`: `<notes>/yt-transcribe`. The folder is created if it does not exist;