MeetingAnalysis

Transforme reuniões em resumos estruturados e itens de ação rastreados. Transcreve gravações localmente, importa notas do Google Meet/Gemini ou aceita transcrições coladas; gera um resumo com decisões e uma tabela de ações; envia apenas seus itens para o rastreador BattlePlan.

O que é MeetingAnalysis?

O MeetingAnalysis é uma skill para agentes de IA (como Claude Code, Cursor ou Codex) que processa reuniões a partir de gravações, notas ou transcrições coladas e produz um resumo estruturado com decisões e uma tabela de ações, enviando apenas os itens de ação do usuário para o rastreador BattlePlan. Ele suporta transcrição local via faster-whisper (CUDA, Apple Silicon ou CPU), importação de notas do Google Meet/Gemini por conectores do agente, e ingestão automática de gravações em uma pasta de entrada. Uma invariante rígida garante que nenhuma gravação ou arquivo de mídia seja armazenado dentro de repositórios Git, evitando inchaço permanente do repositório. A skill também lida com contextos confidenciais, correção de nomes de participantes e extração opcional de quadros de vídeo para análise. Ideal para desenvolvedores e equipes que desejam automatizar o registro de reuniões, manter um histórico limpo e integrar ações diretamente a um sistema de tarefas.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que MeetingAnalysis faz?

Gravações, notas ou transcrições coladas entram; um resumo curto e estruturado e seus itens de ação saem. Cada caminho, pessoa e conta vem da configuração do usuário, nunca desta skill.

Etapa 0 — toda invocação começa aqui

MA="${SKILLS_HOME:-$HOME/.claude/skills}/MeetingAnalysis/Tools"
python3 "$MA/meeting_config.py" check            # ok: true, ou a lista de problemas
python3 "$MA/meeting_config.py" show <contexto>   # o perfil resolvido para um contexto

Sem configuração, ou um problema listado → execute Workflows/Setup.md primeiro. A configuração está em $MEETING_ANALYSIS_CONFIG, senão ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/MeetingAnalysis/config.json.

Fluxos de Trabalho

GatilhoFluxo de Trabalho
primeiro uso, novo contexto, novo provedor de notas, "configurar análise de reunião"Setup
um caminho de gravação, "analisar esta reunião"Analyze: realocar → transcrever → quadros → resumir → rastreador → arquivar → verificar
"apenas transcrever"TranscribeOnly
"importar notas de reunião", notas do Gemini, uma transcrição colada de um anotador, um link de reuniãoImportNotes
/MeetingAnalysis ingest <contexto> --unattended, "caixa de entrada de reuniões", agendamentoAutoIngest

INVARIANTE ABSOLUTA — sem mídia em um repositório

As pastas de reunião geralmente estão dentro de um repositório git (um repositório de notas, um segundo cérebro). O Git mantém cada blob confirmado para sempre: uma gravação de 800 MB custa 800 MB em cada clone, permanentemente, e excluir o arquivo depois não devolve o espaço.

Permitido em uma pasta de reuniãoProibido
.md, .txt, .json, .jsonlvídeo: .mp4 .mkv .mov .webm .avi
no máximo 5 .jpg excepcionais, ≤ 1 MB no total (§ Quadros)áudio: .wav .mp3 .m4a, qualquer áudio extraído
quadros .png, qualquer arquivo acima de 20 MB
  1. A gravação original nunca é copiada ou movida para dentro de uma pasta de reunião. O resumo a nomeia.
  2. Se uma gravação de entrada estiver dentro de uma árvore de trabalho git, mova-a para recordings_archive primeiro, depois trabalhe a partir do novo caminho.
  3. Áudio e quadros temporários vão para um diretório temp e são deletados na limpeza.
  4. A § Verificação não deve imprimir nada antes de relatar sucesso.

meeting_config.py check recusa um recordings_archive ou diretório base de ingestão dentro de uma árvore de trabalho git.

Contextos confidenciais

"confidential": true significa que a reunião pertence a um empregador ou cliente e a pasta da reunião ou o rastreador é pessoal. Então: nenhuma transcrição literal ou notas copiadas (o resumo linka para a fonte), resumos em termos genéricos (decisões, tópicos, responsáveis, IDs de tickets), nenhum hostname, IP, ID de conta, credenciais, nomes de clientes ou dados de clientes, e itens do rastreador como TICKET-ID: resumo genérico curto.

Formato de saída

<diretorio_reunioes>/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>-summary.md
├── YYYY-MM-DD-<slug>-transcript.txt     # linhas [MM:SS]   (não para contextos confidenciais)
├── YYYY-MM-DD-<slug>-transcript.json    # segmentos        (não para contextos confidenciais)
└── frames/                              # raro; ≤ 5 jpg, ≤ 1 MB

<slug> é curto em kebab-case a partir do título da reunião (weekly-status, pricing-review; adicione o nome da outra pessoa para 1:1s). Resumo:

# <Título da reunião> — YYYY-MM-DD

**Participantes:** …
**Fonte:** <nome do arquivo de gravação (arquivado fora do repositório) | link do documento de notas | transcrição colada de <ferramenta>>
**Transcrição:** <nome do arquivo | link | não copiada>

---

## Contexto
## Tópicos Discutidos
### 1. <Tópico> (MM:SS–MM:SS)
## Decisões
## Itens de Ação Imediatos
| # | Ação | Responsável | Prioridade | Prazo |
|---|------|-------------|------------|-------|
## Principais Conclusões

A tabela de ações lista todos os responsáveis para que o registro esteja completo; apenas os seus vão para o rastreador.

Itens de ação → rastreador

tracker: "BattlePlan" na configuração envia seus itens através do batch-add idempotente do BattlePlan ("none" pula a etapa). Seus itens significam: o responsável é você ou um de seus owner_aliases, você é um dos vários responsáveis, ou "nós/o time" em uma reunião que você participou. Subcontexto: primeira regex de tracker_sub_context_rules que corresponder à ação, senão o tracker_sub_context do contexto. Resolva prazos relativos em relação à data da reunião. Fonte: Reunião: <título> YYYY-MM-DD (gravação|notas|colado), estável entre execuções porque as chaves de deduplicação estão nela. Mostre um --dry-run e obtenha um sim a menos que esteja executando em modo não supervisionado.

Nomes

Reconhecimento de fala e anotadores distorcem nomes. Corrija-os contra o arquivo de roster (roster_file: uma pessoa por linha, Nome: alias, erro de grafia, …) e a lista de participantes (evento de calendário ou cabeçalho de notas). Marque correções de baixa confiança como Nome (?); nunca adivinhe.

Quadros (apenas vídeo; apenas temporários)

Quadros são entrada para análise, não um entregável. Extraia para um diretório temp, leia-os, escreva o que mostram no resumo (slides → texto chave; compartilhamentos de tela → o que foi mostrado; estrutura → um diagrama mermaid), então os delete.

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

Mantenha um quadro apenas se todas as condições forem verdadeiras: seu conteúdo não pode ser expresso como texto, uma tabela ou mermaid; é denso (não uma visão geral de galeria ou slide de título); as conclusões do resumo dependem dele; e o resumo o referencia pelo nome. Salve os quadros mantidos como ffmpeg -i in.png -vf scale=1280:-2 -q:v 4 frames/partN_MMmSSs.jpg. Quando estiver em dúvida, descarte: a gravação e o timestamp permanecem.

Verificação

find "<pasta da reunião>" -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 "<pasta da reunião>" -path '*/frames/*' -type f | wc -l      # deve ser ≤ 5

Saída vazia é a única aprovação. Qualquer coisa listada: mova para fora, informe o usuário, não reporte sucesso.

Ferramentas

FerramentaFaz
`meeting_config.py checkshow
`transcribe.py REC --out-base DIR/transcript [--lang autoen
`run_ingest.sh --context NOME [--install--check

Dependências

uv (scripts declaram suas próprias dependências Python). ffmpeg apenas para extração de quadros. Uma GPU é opcional: na CPU, uma reunião de uma hora leva cerca de duas horas com turbo. A importação de notas precisa dos conectores do Google Drive / Docs do agente (e opcionalmente Gmail, Calendário) para a conta correta.

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

Habilidades Relacionadas