MeetingAnalysis

Verwandelt Besprechungen in strukturierte Zusammenfassungen und nachverfolgbare Aktionspunkte. Transkribiert Aufnahmen lokal (faster-whisper auf CUDA, Apple Silicon oder CPU), importiert Google Meet-/Gemini-Notizen über Konnektoren oder übernimmt eingefügte Notizen-Transkripte; erstellt eine Zusammenfassung mit Entscheidungen und einer Aktionstabelle; überträgt nur die eigenen Punkte in den BattlePlan-Tracker. Enthält einen unbeaufsichtigten Inbox-Eingang (Aufnahme ablegen, Zusammenfassung erhalten) und eine feste Regel, dass Aufnahmen nie in einem Git-Repo landen.

Was ist MeetingAnalysis?

MeetingAnalysis ist ein KI-Agenten-Skill, der Besprechungsaufzeichnungen, Notizen oder eingefügte Transkripte entgegennimmt und daraus kurze, strukturierte Zusammenfassungen sowie persönliche Aktionspunkte erstellt. Er unterstützt lokale Transkription mit faster-whisper (CUDA, Apple Silicon oder CPU) und kann Notizen aus Google Meet oder Gemini über Konnektoren importieren. Der Skill arbeitet konfigurationsbasiert: Pfade, Personen und Konten stammen ausschließlich aus der Benutzerkonfiguration. Er bietet dedizierte Workflows für die Ersteinrichtung, die Analyse einer Aufnahme, reine Transkription, Notizenimport und unbeaufsichtigten Inbox-Betrieb. Eine wichtige HARD-INVARIANTE stellt sicher, dass niemals Mediendateien (Audio/Video) in einem Git-Repo landen – Aufnahmen werden vor der Verarbeitung in ein externes Archiv verschoben. Der Skill erzeugt ein standardisiertes Ausgabeformat mit Zusammenfassung, optionalem Transkript und ggf. seltenen Frames (max. 5 JPG, ≤1 MB). Vertrauliche Kontexte unterdrücken wörtliche Transkripte und genericieren Zusammenfassungen. Aktionspunkte können über den BattlePlan-Tracker (idempotentes batch-add) nachverfolgt werden, wobei nur die eigenen Einträge übertragen werden. Der Skill ist für Claude Code, Cursor, Codex und andere KI-Agenten-Plattformen geeignet.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/MeetingAnalysis

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht MeetingAnalysis?

Aufnahmen, Notizen oder eingefügte Transkripte hinein – eine kurze, strukturierte Zusammenfassung und Ihre Aktionspunkte heraus. Jeder Pfad, jede Person und jedes Konto stammt aus der Benutzerkonfiguration, niemals aus diesem Skill.

Schritt 0 — jeder Aufruf beginnt hier

MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check            # ok: true, oder die Liste der Probleme
python3 "$MA/meeting_config.py" show <context>   # das aufgelöste Profil für einen Kontext

Keine Konfiguration oder ein Problem aufgelistet → zuerst Workflows/Setup.md ausführen. Die Konfiguration liegt unter $MEETING_ANALYSIS_CONFIG, sonst ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.

Workflows

AuslöserWorkflow
Erste Verwendung, neuer Kontext, neuer Notizen-Anbieter, "Meeting-Analyse einrichten"Setup
Ein Aufnahmepfad, "dieses Meeting analysieren"Analyze: verschieben → transkribieren → Frames → zusammenfassen → Tracker → archivieren → verifizieren
"Nur transkribieren"TranscribeOnly
"Meeting-Notizen importieren", Gemini-Notizen, ein eingefügtes Notizen-Transkript, ein Meeting-LinkImportNotes
/MeetingAnalysis ingest <context> --unattended, "Meeting-Inbox", ZeitplanungAutoIngest

HARTE INVARIANTE — keine Medien in einem Repository

Meeting-Ordner befinden sich normalerweise in einem Git-Repository (Notizen-Repo, Second Brain). Git behält jeden committeten Blob für immer: Eine 800 MB große Aufnahme kostet 800 MB bei jedem Klon, dauerhaft, und das spätere Löschen der Datei gibt den Speicherplatz nicht zurück.

Erlaubt in einem Meeting-OrdnerVerboten
.md, .txt, .json, .jsonlVideo: .mp4 .mkv .mov .webm .avi
Maximal 5 ausnahmsweise .jpg-Keyframes, ≤ 1 MB insgesamt (§ Frames)Audio: .wav .mp3 .m4a, jegliches extrahierte Audio
.png-Frames, jede Datei über 20 MB
  1. Die Quellaufnahme wird niemals in einen Meeting-Ordner kopiert oder verschoben. Die Zusammenfassung benennt sie.
  2. Wenn sich eine Eingabeaufnahme innerhalb eines Git-Worktrees befindet, verschieben Sie sie zuerst in recordings_archive und arbeiten Sie dann vom neuen Pfad aus.
  3. Temporäre Audio- und Framedateien gehen in ein temporäres Verzeichnis und werden bei der Bereinigung gelöscht.
  4. § Verifikation muss vor dem Melden des Erfolgs nichts ausgeben.

meeting_config.py check lehnt ein recordings_archive oder Ingest-Stammverzeichnis innerhalb eines Git-Worktrees ab.

Vertrauliche Kontexte

"confidential": true bedeutet, dass das Meeting einem Arbeitgeber oder Kunden gehört und der Meeting-Ordner oder Tracker persönlich ist. Dann: kein wörtliches Transkript oder kopierte Notizen (die Zusammenfassung verlinkt stattdessen auf die Quelle), Zusammenfassungen in generischen Begriffen (Entscheidungen, Themen, Verantwortliche, Ticket-IDs), keine Hostnamen, IPs, Konten-IDs, Anmeldedaten, Kundennamen oder Kundendaten, und Tracker-Einträge als TICKET-ID: kurze generische Zusammenfassung.

Ausgabeformat

<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt     # [MM:SS]-Zeilen   (nicht für vertrauliche Kontexte)
├── YYYY-MM-DD-<slug>-transcript.json    # Segmente          (nicht für vertrauliche Kontexte)
└── frames/                              # selten; ≤ 5 jpg, ≤ 1 MB

<slug> ist ein kurzer Kebab-Case vom Meeting-Titel (weekly-status, pricing-review; für 1:1-Gespräche den Namen der anderen Person hinzufügen). Zusammenfassung:

# <Meeting-Titel> — YYYY-MM-DD

**Teilnehmer:** …
**Quelle:** <Aufnahmedateiname (außerhalb des Repos archiviert) | Notizen-Dokument-Link | eingefügtes Transkript von <Tool>>
**Transkript:** <Dateiname | Link | nicht kopiert>

---

## Kontext
## Besprochene Themen
### 1. <Thema> (MM:SS–MM:SS)
## Entscheidungen
## Sofortige Aktionspunkte
| # | Aktion | Verantwortlicher | Priorität | Fälligkeitsdatum |
|---|--------|-----------------|-----------|------------------|
## Wichtige Erkenntnisse

Die Aktionstabelle listet jeden Verantwortlichen auf, damit der Datensatz vollständig ist; nur Ihre eigenen Punkte gehen an den Tracker.

Aktionspunkte → Tracker

tracker: "BattlePlan" in der Konfiguration sendet Ihre Punkte über BattlePlans idempotentes batch-add ("none" überspringt den Schritt). Ihre eigenen Punkte bedeutet: Verantwortlicher sind Sie oder einer Ihrer owner_aliases, Sie sind einer von mehreren Verantwortlichen, oder „wir/das Team“ in einem Meeting, an dem Sie teilgenommen haben. Unter-Kontext: erster Treffer von tracker_sub_context_rules Regex auf der Aktion, sonst der tracker_sub_context des Kontexts. Relative Fälligkeiten relativ zum Meeting-Datum auflösen. Quelle: Meeting: <Titel> YYYY-MM-DD (recording|notes|pasted), stabil über Ausführungen hinweg, da Deduplizierung darauf basiert. Zeigen Sie ein --dry-run an und holen Sie ein Ja ein, es sei denn, es läuft unbeaufsichtigt.

Namen

Spracherkennung und Notizen-Dienste verhunzen Namen. Korrigieren Sie sie anhand der Teammitglieder-Datei (roster_file: eine Person pro Zeile, Name: Alias, Falschschreibung, …) und der Teilnehmerliste (Kalenderereignis oder Notizenkopf). Markieren Sie Korrekturen mit geringer Vertrauenswürdigkeit als Name (?); raten Sie niemals.

Frames (nur Video; nur temporär)

Frames sind Analyse-Eingabe, kein Auslieferungsgegenstand. In ein temporäres Verzeichnis extrahieren, lesen, was sie zeigen, in die Zusammenfassung schreiben (Folien → Schlüsseltext; Bildschirmfreigaben → was gezeigt wurde; Struktur → ein Mermaid-Diagramm) und dann löschen.

ffmpeg -i <video> -vf "select='gt(scene,0.3)',showinfo" -vsync vfr "$TMP/frames/part1_%03d.png"   # 0.15 wenn < 2 Frames

Behalten Sie einen Frame nur, wenn alle zutreffen: sein Inhalt kann nicht als Text, Tabelle oder Mermaid ausgedrückt werden; er ist dicht (keine Galerieansicht oder Titelfolie); die Schlussfolgerungen der Zusammenfassung hängen davon ab; und die Zusammenfassung verweist namentlich darauf. Behaltene Frames speichern als ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Im Zweifelsfall verwerfen: Die Aufnahme und der Zeitstempel bleiben erhalten.

Verifikation

find "<Meeting-Ordner>" -type f \( -iname '*.mp4' -o -iname '*.mkv' -o -iname '*.mov' -o -iname '*.webm' -o \
  -iname '*.avi' -o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.m4a' -o -iname '*.png' -o -size +20M \) -print
find "<Meeting-Ordner>" -path '*/frames/*' -type f | wc -l      # muss ≤ 5 sein

Leere Ausgabe ist der einzige Bestehen-Fall. Bei irgendeiner Ausgabe: Datei entfernen, den Benutzer informieren, keinen Erfolg melden.

Werkzeuge

ToolAufgabe
`meeting_config.py checkshow
`transcribe.py REC --out-base VERZ/transkript [--lang autoen
`run_ingest.sh --context NAME [--install--check

Abhängigkeiten

uv (Skripte deklarieren ihre eigenen Python-Abhängigkeiten). ffmpeg nur für Frameextraktion. Eine GPU ist optional: Auf der CPU dauert ein einstündiges Meeting mit turbo etwa zwei Stunden. Notizenimport benötigt die Google Drive / Docs-Konnektoren (und optional Gmail, Kalender) des Agenten für das richtige Konto.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

CodeQuality

Code quality loop for any repo, seen through two lenses — a tool lens (linters, type checkers, security, dead-code and duplication scanners; fix by P0 security → P1 correctness → P2 maintainability) and a principle lens (SOLID + Clean Code smells; one principle at a time, propose → confirm → apply behind characterization tests). One manifest of free local tools, one scan, one fix loop, one mandatory Quality Improvement Report. USE WHEN improve code quality, analyze code, fix linting, reduce duplication, add types, security scan, test coverage, refactor, improve code design, apply SOLID, clean code refactor, reduce complexity, kill code smells, make code maintainable, refactor legacy code, single responsibility, dependency inversion, remediation sprint, install quality tools, quality baseline, smell report, refactoring roadmap, what should we fix first. NOT FOR the issue lifecycle, branches, PRs or merging (use IssueFlow; its Remediation workflow calls this skill to pick and scope the w

Verwandte Skills