MeetingAnalysis

Convierte reuniones en resúmenes estructurados y tareas rastreables. Transcripción local (faster-whisper en CUDA, Apple Silicon o CPU), importa notas de Google Meet/Gemini mediante conectores, o acepta transcripciones pegadas; escribe un resumen con decisiones y una tabla de acciones; envía solo tus tareas al gestor BattlePlan.

¿Qué es MeetingAnalysis?

MeetingAnalysis es una skill para agentes de IA como Claude Code o Cursor que automatiza el procesamiento de reuniones: transcripción, resumen estructurado y registro de tareas. Soporta múltiples fuentes: archivos de grabación local (transcripción con faster-whisper en GPU NVIDIA, Apple Silicon o CPU), notas desde Google Meet o Gemini mediante conectores de Google, o transcripciones pegadas manualmente. La skill genera un resumen en markdown con contexto, temas discutidos, decisiones y una tabla de acciones. Luego, identifica tus tareas personales (según alias configurados) y las envía al gestor de tareas BattlePlan de forma idempotente, evitando duplicados. Todo el proceso respeta la privacidad: las grabaciones nunca se almacenan en repositorios git, y los contextos confidenciales omiten transcripciones literales y datos sensibles. También incluye un modo de ingesta desatendida (inbox) que procesa grabaciones automáticamente y un asistente de configuración para nuevos contextos. Es ideal para equipos que quieren centralizar el seguimiento de decisiones y acciones sin exponer información sensible.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace MeetingAnalysis?

Grabaciones, notas o transcripciones pegadas como entrada; un resumen corto y estructurado y tus tareas como salida. Cada ruta, persona y cuenta proviene de la configuración del usuario, nunca de esta skill.

Paso 0 — toda invocación comienza aquí

MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check            # ok: true, o la lista de problemas
python3 "$MA/meeting_config.py" show <context>   # el perfil resuelto para un contexto

Sin configuración, o si hay algún problema listado → ejecuta primero Workflows/Setup.md. La configuración reside en $MEETING_ANALYSIS_CONFIG, o si no ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.

Flujos de trabajo

DisparadorFlujo de trabajo
primer uso, nuevo contexto, nuevo proveedor de notas, "configurar análisis de reuniones"Setup
una ruta de grabación, "analizar esta reunión"Analyze: reubicar → transcribir → fotogramas → resumir → tracker → archivar → verificar
"solo transcribir"TranscribeOnly
"importar notas de reunión", notas de Gemini, una transcripción pegada de un notetaker, un enlace de reuniónImportNotes
/MeetingAnalysis ingest <context> --unattended, "bandeja de entrada de reuniones", programaciónAutoIngest

INVARIANTE ABSOLUTO — sin medios en un repo

Las carpetas de reuniones suelen estar dentro de un repositorio git (un repositorio de notas, un segundo cerebro). Git conserva cada blob confirmado para siempre: una grabación de 800 MB cuesta 800 MB en cada clon, permanentemente, y eliminar el archivo más tarde no recupera el espacio.

Permitido en una carpeta de reuniónProhibido
.md, .txt, .json, .jsonlvideo: .mp4 .mkv .mov .webm .avi
como máximo 5 fotogramas .jpg excepcionales, ≤ 1 MB en total (§ Fotogramas)audio: .wav .mp3 .m4a, cualquier audio extraído
fotogramas .png, cualquier archivo mayor de 20 MB
  1. La grabación original nunca se copia ni mueve a una carpeta de reunión. El resumen la nombra.
  2. Si una grabación de entrada está dentro de un árbol de trabajo git, muévela primero a recordings_archive, luego trabaja desde la nueva ruta.
  3. El audio temporal y los fotogramas van a un directorio temporal y se eliminan durante la limpieza.
  4. § Verificación no debe imprimir nada antes de informar éxito.

meeting_config.py check rechaza un recordings_archive o un directorio de ingesta dentro de un árbol de trabajo git.

Contextos confidenciales

"confidential": true significa que la reunión pertenece a un empleador o cliente y la carpeta de la reunión o el tracker es personal. Entonces: no se copia transcripción ni notas literales (el resumen enlaza a la fuente), resúmenes en términos genéricos (decisiones, temas, responsables, IDs de tickets), sin nombres de host, IPs, IDs de cuenta, credenciales, nombres de clientes ni datos de clientes, y los elementos del tracker como TICKET-ID: resumen genérico corto.

Formato de salida

<meetings_dir>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt     # líneas [MM:SS]   (no en contextos confidenciales)
├── YYYY-MM-DD-<slug>-transcript.json    # segmentos        (no en contextos confidenciales)
└── frames/                              # raro; ≤ 5 jpg, ≤ 1 MB

<slug> es kebab-case corto del título de la reunión (weekly-status, pricing-review; añade el nombre de la otra persona para reuniones 1:1). Resumen:

# <Título de la reunión> — YYYY-MM-DD

**Asistentes:** …
**Fuente:** <nombre de archivo de grabación (archivado fuera del repo) | enlace al documento de notas | transcripción pegada de <herramienta>>
**Transcripción:** <nombre de archivo | enlace | no copiada>

---

## Contexto
## Temas discutidos
### 1. <Tema> (MM:SS–MM:SS)
## Decisiones
## Acciones inmediatas
| # | Acción | Responsable | Prioridad | Fecha límite |
|---|--------|-------------|-----------|--------------|
## Conclusiones clave

La tabla de acciones lista todos los responsables para que el registro esté completo; solo tus acciones van al tracker.

Acciones → tracker

tracker: "BattlePlan" en la configuración envía tus acciones mediante batch-add idempotente de BattlePlan ("none" omite el paso). Tus acciones significa: el responsable eres tú o uno de tus owner_aliases, eres uno de varios responsables, o "nosotros/el equipo" en una reunión a la que asististe. Sub-contexto: primera coincidencia de tracker_sub_context_rules regex en la acción, o si no el tracker_sub_context del contexto. Resuelve fechas límite relativas contra la fecha de la reunión. Fuente: Meeting: <título> YYYY-MM-DD (recording|notes|pasted), estable entre ejecuciones porque las claves de deduplicación se basan en ello. Muestra un --dry-run y pide confirmación a menos que se ejecute desatendido.

Nombres

El reconocimiento de voz y los anotadores distorsionan los nombres. Corrígelos contra el archivo de plantilla (roster_file: una persona por línea, Nombre: alias, error ortográfico, …) y la lista de asistentes (evento de calendario o encabezado de notas). Marca las correcciones de baja confianza Nombre (?); nunca adivines.

Fotogramas (solo video; solo temporales)

Los fotogramas son entrada para el análisis, no un entregable. Extráelos a un directorio temporal, léelos, escribe lo que muestran en el resumen (diapositivas → texto clave; compartir pantalla → lo que se mostró; estructura → un diagrama mermaid), luego elimínalos.

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

Conserva un fotograma solo si todas se cumplen: su contenido no se puede expresar como texto, tabla o mermaid; es denso (no una vista de galería o diapositiva de título); las conclusiones del resumen dependen de él; y el resumen lo referencia por nombre. Guarda los fotogramas conservados como ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Ante la duda, descarta: la grabación y la marca de tiempo permanecen.

Verificación

find "<carpeta de reunión>" -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 "<carpeta de reunión>" -path '*/frames/*' -type f | wc -l      # debe ser ≤ 5

La salida vacía es la única aprobación. Si hay algo listado: muévelo fuera, informa al usuario, no reportes éxito.

Herramientas

HerramientaFunción
`meeting_config.py checkshow
`transcribe.py REC --out-base DIR/transcript [--lang autoen
`run_ingest.sh --context NAME [--install--check

Dependencias

uv (los scripts declaran sus propias dependencias Python). ffmpeg solo para extracción de fotogramas. Una GPU es opcional: en CPU, una reunión de una hora toma aproximadamente dos horas con turbo. La importación de notas necesita los conectores de Google Drive / Docs (y opcionalmente Gmail, Calendar) del agente para la cuenta correcta.

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

Skills relacionados