Communitygithub.com

Transcrever Gravações

Transforme notas de voz, reuniões, entrevistas, palestras ou gravações de podcast locais em transcrições, notas, resumos ou itens de ação, de forma privada no computador do usuário, usando as ferramentas MCP do Yap (transcribe_audio, search_dictations). Use quando o usuário mencionar um arquivo de áudio ou vídeo, uma gravação, uma nota de voz ou algo que ditou anteriormente.

O que é Transcrever Gravações?

Este skill permite transcrever áudio localmente no computador do usuário, sem enviar dados para a nuvem, utilizando o servidor MCP Yap. Ele suporta 25 idiomas europeus (detectados automaticamente) por meio do modelo NVIDIA Parakeet, que é baixado uma vez (cerca de 670 MB). O skill atende a dois cenários principais: quando o usuário aponta para um arquivo de gravação específico (voz, reunião, podcast, etc.) e quando se refere a algo que disse ou ditou anteriormente. No primeiro caso, o skill obtém o caminho absoluto do arquivo, chama a ferramenta `transcribe_audio` (com opção de timestamps para arquivos longos) e entrega o resultado conforme solicitado (transcrição limpa, resumo, notas com decisões e itens de ação, citações com timestamps ou tradução). No segundo caso, utiliza `search_dictations` para buscar na história do aplicativo de ditado Yap. O skill enfatiza a privacidade, a fidelidade da transcrição e a adaptação ao idioma do usuário, sendo compatível com ferramentas como Claude Code, Cursor e Codex que suportam o protocolo MCP.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/founden-bot/yap-mcp/tree/main/skills/transcribe-recordings

Perguntar na sua IA favorita

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

Documentação

Transcrever gravações com Yap

O Yap MCP transcreve áudio no próprio computador do usuário (NVIDIA Parakeet, 25 idiomas europeus, detectados automaticamente). Nada é enviado para a nuvem. Estas etapas assumem que o servidor MCP yap está conectado (npx -y github:founden-bot/yap-mcp).

Quando o usuário aponta para uma gravação

  1. Obtenha o caminho absoluto do arquivo. Se o usuário apenas descrever a gravação ("o memorando na minha área de trabalho"), pergunte pelo caminho ou nome do arquivo; um ~ no início é aceitável.
  2. Chame transcribe_audio com path. Passe timestamps: true para gravações com mais de alguns minutos ou quando o usuário quiser encontrar momentos posteriormente.
  3. Se a resposta indicar que o modelo de fala ainda está sendo baixado (apenas na primeira utilização, cerca de 670 MB), informe ao usuário que é um download único e chame a ferramenta novamente um minuto depois. Não mude para um serviço na nuvem.
  4. Faça o que o usuário solicitou com o texto: uma transcrição limpa, um resumo, notas de reunião com decisões e itens de ação (responsável, tarefa, data mencionada), citações com seus timestamps ou uma tradução.
  5. Cite a transcrição fielmente. Marque palavras sobre as quais você não tem certeza, em vez de adivinhar nomes ou números.

Quando o usuário se refere a algo que disse ou ditou

Chame search_dictations com algumas palavras distintivas (query) e uma janela de tempo (days). A ferramenta lê o histórico do aplicativo de ditado Yap neste computador, apenas para leitura. Se não houver correspondência, amplie days ou tente outras palavras antes de afirmar que não está lá.

Boas práticas padrão

  • Vários arquivos: transcreva-os um por um e mantenha cada resultado sob o nome do arquivo.
  • Gravações longas: resuma primeiro por seção com timestamp e, em seguida, faça um resumo geral.
  • Mantenha o idioma do usuário: responda no idioma da gravação, a menos que o usuário peça o contrário.

Habilidades Relacionadas