--- name: sammanfatta-media description: Sammanfattar YouTube-videor (och i framtiden andra mediakällor). Stödjer chatt-svar och filrapporter (docx/md/pdf) med valbar diagnostik på nivå 0–3. Aktiveras av "/sammanfatta-media " eller naturligspråkliga formuleringar som "sammanfatta denna video", "ge mig en rapport om denna video", "djävulens advokat på den här". Klarar enskild URL, flera URL:er och spellistor. --- # sammanfatta-media Återanvändbart arbetsflöde för att sammanfatta YouTube-videor (och framtida mediakällor). Stödjer två leveranslägen, tre inmatningsformer och fyra diagnostiknivåer. ## Konfiguration och sökvägar Läs `~/.claude/skills/sammanfatta-media/config.yml` i början av varje körning för att hämta `output_dir`, `inbox_dir`, `default_lang`, `cookies_browser` och `user_context`. Om filen saknas: be användaren kopiera `config.yml.example` till `config.yml` och fylla i sina sökvägar. Skriptmapp och kataloger — konstruera plattformsoberoende via Python: ```python from pathlib import Path SKILL_DIR = Path.home() / ".claude" / "skills" / "sammanfatta-media" TRANSCRIPTS_DIR = Path(config["transcripts_dir"]).expanduser() OUTPUT_DIR = Path(config["output_dir"]).expanduser() TRANSCRIPTS_DIR.mkdir(parents=True, exist_ok=True) ``` Standardkommandon: ```bash # Hämta transkription — sparas permanent i transcripts_dir python "{SKILL_DIR}/hamta_transkription.py" \ --output "{TRANSCRIPTS_DIR}/sammanfatta-.txt" \ --lang # Bygg docx-rapport python "{SKILL_DIR}/bygg_rapport.py" ``` ## Triggerigenkänning Skillen aktiveras av `/sammanfatta-media` följt av URL eller bifogad transkription, samt av naturligspråkliga formuleringar. ### Chatt-läge (utan filgenerering) - `/sammanfatta-media ` - "sammanfatta denna video" (med bifogad transkription) - "berätta om denna video" - "summera den här videon" ### Rapport-läge (genererar fil) [video] = platshållare för "denna video/dessa videos/filmerna i denna spellista" - "ge mig en rapport om [video]" - "skriv en rapport om [video]" - "sammanfatta [video] som en rapport" - "skapa en rapport om [video]" - "...och skapa en rapport" / "...som en rapport" ### Diagnostik-tillägg Aktiveras endast om användaren uttryckligen ber om det. Kan begäras i chatt- eller rapport-läge, initialt eller som uppföljning. | Nivå | Triggers | Innehåll | |------|----------|----------| | **0: Ingen** | (inget) | Bara sammanfattning + källista | | **1: Enkel bedömning** | "diagnostik", "bedömning" | Uppenbara svagheter, lösa trådar. Jämför mot `user_context` om angivet + kort meningsmotståndarperspektiv. | | **2: Kritisk analys** | "hitta svagheter", "kritisk bedömning", "analys" | Hårdare och mer detaljerad än nivå 1. | | **3: Skarp kritik** | "skarp kritik", "djävulens advokat", "ge motargument" | Ärlig opponent. Artig men skoningslös i sak. **Inga hänsyn till user_context.** | ## Inmatningsformer (i prioritetsordning) ### Form A — yt-dlp captions (primärväg) Standardförfarandet för YouTube-videor. Kör `hamta_transkription.py` enligt ovan. Skriptet försöker i tur och ordning: 1. Manuella undertexter (bäst kvalitet — fackord och namn) 2. Auto-genererade undertexter (språk enligt `default_lang`) 3. Om bot-detection: automatiskt omförsök med `--cookies-from-browser ` Vid framgång: gå direkt till Steg 3 (sammanfattning). Metadata sparas parallellt i `.meta.json`. Transkriptionen och dess `.meta.json` sparas permanent i `transcripts_dir`. De ligger kvar efter körningen och kan återanvändas. **Bot-detection-varning:** Om yt-dlp rapporterar "Sign in to confirm" körs cookies-läget automatiskt. Misslyckas det också: gå till Form C. ### Form B — Whisper-fallback Om Form A misslyckas (inga captions, geo-block, åldersgräns): ```bash python "{SKILL_DIR}/whisper_fallback.py" \ --output "{TEMP_DIR}/sammanfatta-.txt" ``` Skriptet hämtar audio med yt-dlp och transkriberar med faster-whisper. Meddela användaren att det tar tid (5–10 min/timme på CPU). För svenska: använd KBLab-modellen (`KBLab/kb-whisper-large`). **OBS:** `whisper_fallback.py` är ännu inte implementerad — byggs när behovet uppstår. ### Form C — Manuell inklistring Sista utväg om Form A och B misslyckas. Be användaren: > "Klistra in transkriptet — öppna YouTube, klicka på `...mer` under videon och sedan på `Visa transkription`, markera och klistra in i nästa meddelande." ## Flera videor och spellistor Vid flera URL:er: 1. Identifiera alla videor, bevara ordningen 2. Hämta metadata och transkription per video (Form A för var och en) 3. Sammanfatta varje video separat 4. Skapa samlad syntes 5. Skapa gemensam källista med videoreferenser och timestamps ### Spellistehantering ```bash yt-dlp --flat-playlist --print "%(playlist_index)s|%(title)s|%(duration)s|%(upload_date)s|%(id)s" ``` - **≤ 5 videor**: bearbeta alla utan att fråga - **> 5 videor**: räkna och fråga hur användaren vill fortsätta Svarsformer användaren kan ge: "de fem första", "nummer 6–10", "alla", "visa mig en lista". **Numrerad lista** (när användaren ber om "lista"): ``` Spellistan innehåller N videor: 1. [Titel] — 12:34 — 2025-03-15 2. [Titel] — 1:02:11 — 2025-03-22 ``` **Enskild URL i spellista:** Om URL:en innehåller `&list=...` men pekar på en enskild video: bearbeta bara den videon. ## Metadata och videobeskrivning Samla för varje video: - titel, kanal, URL, publiceringsdatum, längd - videobeskrivning och dess inbäddade länkar - kapitel/timestamps (om tillgängliga) - spellisteposition (om relevant) **Visuell separation:** Skilj alltid videobeskrivning, transkription och Claudes sammanfattning med egna H2/H3-rubriker. Blanda dem aldrig i samma stycke. Citat ur videobeskrivningen: blockquote eller indenterat citat. ## Arbetsflöde ### Steg 1 — Identifiera läge och behov Läs användarens meddelande och avgör: - **Leveransläge**: chatt eller rapport? - **Diagnostiknivå**: 0, 1, 2 eller 3? - **Inmatning**: URL eller bifogad transkription? - **Antal videor**: en eller flera? Om användaren säger "rapport" utan format, fråga: ``` Vilket format vill du ha rapporten i? - Word (.docx) - Markdown (.md) - PDF (.pdf) ``` Fråga inte om format är redan angivet. Fråga inte om diagnostiknivå. ### Steg 2 — Hämta transkription Följ Form A → B → C ovan. **Vid saknad transkription**: säg det tydligt. Gör ingen fullständig analys som om transkriptionen funnits. Fortsätt med metadata och beskrivning om möjligt. ### Steg 3 — Producera sammanfattning Standardformat: - **Tes** — videons huvudpåstående (1–2 meningar) - **Huvudlinjer** — numrerade avsnitt som speglar videons struktur - **Slutsats** — vad videon vill driva Längd: anpassad till videons längd och komplexitet. **Vid flera videor**: sammanfatta varje separat, lägg sedan till samlad syntes med: - Gemensamma teman och argumentationslinjer - Skillnader och inbördes spänningar - Gemensamma källor och referenser - En övergripande linje (om urskiljbar) **Chatt-läge utan diagnostik**: avsluta med kort neutral fråga om användaren vill ha rapport eller diagnostik. Inte säljande — bara informativt. ### Steg 4 — Diagnostik (endast om begärd) **Nivå 1–2**: om `user_context` är angivet i config.yml, anpassa analysen efter det. Påpeka svagheter och lösa trådar, flagga och förklara, argumentera inte emot. **Nivå 3**: agera som ärlig opponent. Motpartens bästa argument utan kompromiss. Ignorera `user_context`. Strukturera efter vad som faktiskt är problematiskt. Vanliga rubriker: - Forskningsläget framställs mer enigt än det är - Specifika tolkningar som är omstridda - Metodologiska problem - Polemisk inramning - Vad som inte diskuteras - Eventuella faktafel ### Steg 5 — Rapport (endast om begärd) Default-struktur: 1. **Titelsida** — videons titel, URL, datum, rapportnivå 2. **Sammanfattning** (från Steg 3) 3. **Kritisk bedömning** (om diagnostik begärdes) 4. **Källor** — alltid videoförankrade; Claudes egna källor endast vid diagnostik 5. **Transkription** — alltid med som sista sektion, med rubrik "Transkription" och källa angiven **Rapportbygge (docx):** Anropa `bygg_rapport.py` med en strukturerad dict. ```python import sys sys.path.insert(0, str(SKILL_DIR)) from bygg_rapport import bygg_rapport data = { "titel": "...", "metadata": [("Källa: ", "YouTube"), ("URL: ", url), ...], "sektioner": [...], } bygg_rapport(data, output_dir / "rapport-.docx") ``` **Slug-generering:** - Enskild video: videons titel - Spellista: spellistans titel - Flera videor utan gemensam spellista: första videons titel + `-plus-N` Normalisering: gemener, å→a, ä→a, ö→o, mellanslag→bindestreck, ta bort specialtecken, max ~60 tecken. **Markdown (.md):** YAML front matter med svenska nyckelnamn (*språk*, *rapportnivå*, *transkriptkälla*). Filnamn: ASCII-normaliserat. **PDF:** Konvertera från docx via pdf-skillen om tillgänglig. ### Steg 5b — Språklig genomgång (OBLIGATORISKT som sista steg för svenska rapporter) Gäller alla rapporter på svenska — alltid, utan att fråga. Genomgången görs på texten **innan** Python-skriptet körs eller filen genereras. Verkställ ändringarna direkt i skriptkoden; presentera inte diagnostiken separat. Återkommande fynd att leta efter och åtgärda: - **Hybridkonstruktioner med engelska förled** (*ghostskrev*, *ghostwriting-karriären*, *ghostwriting-uppdrag*) → ersätt med etablerad svensk form (*spökskrev*, *karriären som spökskrivare*, *spökskrivaruppdrag*) - **Påhittade försvenskningar** (*serieabusare*, *predikoutline*, *attenderar*) → etablerad term eller kursiverat original - **Inkonsekvent transliterering** (*kerubim* vs *cherubim*) → välj ett och håll konsekvent - **Engelska fraser inbäddade i svensk löptext** → översätt eller markera tydligt - **Grammatikfel i genus och numerus** (*ett sträckt hand* → *en sträckt hand*; *ett uppgor* → *en uppgörelse*) - **Oidiomatiska metaforer** - **Raka citattecken** → typografiska (hanteras av bygg_rapport automatiskt i docx) - **Faktafel i ordagranna citat** → dubbelkolla mot transkriptet - **YAML-nyckelnamn** → ska ha svenska bokstäver i .md-rapporter Användaren ser den städade versionen direkt — aldrig ett utkast. ### Steg 6 — Leverans - **Chatt-läge**: sammanfattningen direkt i chatten - **Rapport-läge**: presentera filsökvägen och en kort sammanfattande mening. Inga långa förklaringar. ## Källidentifiering Samla källor löpande under transkriptionsgenomgången. Identifiera: - **Forskare och verk** — även förvanskat uttal. Ange sannolik identifiering vid osäkerhet. - **Primärkällor** — bibelställen, apokryfer, pseudepigrafer, kyrkofäder, rabbinsk litteratur - **Webbplatser och poddar** Källista med tydliga underrubriker. Kursiv för boktitlar, citationstecken för artiklar. ## Källstatus Märk varje källa med en eller flera etiketter (ej ömsesidigt uteslutande, kombinera med semikolon): - explicit nämnd - från videobeskrivning - sannolik identifiering - oklar hänvisning - person nämnd, men inte nödvändigtvis använd som källa ### Presentation Primär form — prosa eller bulletlista under underrubriker: > Boyarin, Daniel. *Border Lines*. (Explicit nämnd; central referens.) > Hurtado, Larry W. *Lord Jesus Christ*. (Sannolik identifiering — videon säger bara "Hurtado".) Sammanfattande översikt sist i källsektionen: | Källa | Typ | Video | Timestamp | Kontext | Status | Länk/identifierare | |---|---|---|---:|---|---|---| | Boyarin, Daniel. *Border Lines*. | Forskning | 1 | 28:22 | Anförs för tesen att... | Explicit nämnd | ISBN 978-0812219869 | Oversiktstabellen är obligatorisk vid flera videor, valfri vid enskild video. ## Inkorg (batch-dispatch) Om `inbox_dir` är angivet i config.yml och användaren ber om det: läs `.txt`-filer i inkorgsmappen (en URL per rad), bearbeta i ordning. Rapporter sparas i `output_dir`. ## Påminnelser - Anpassa expertisen efter videons ämne — inte bara teologi. - Bevara transkriptionsfel som de är — markera inte med [sic]. - Filnamn: `[a-z0-9-]+\.docx` (eller motsv.). Inga diakritiska tecken, inga understreck. - IBM Plex Sans i alla Word-dokument om användaren inte säger annat. - Kör `pip install -U yt-dlp` vid behov — YouTube-API:t ändras ofta.