# Voice Note Ingest

> Ingiere una nota de voz preservando el fraseo exacto (nunca parafraseado) y la enruta a originals/, concepts/, people/, companies/, ideas/, personal/ o voice-notes/ según un árbol de decisión.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/voice-note-ingest
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/voice-note-ingest.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 21 días
Coste de contexto: 59 tok instalada, 1.7k tok al activarse, 1.9k tok con todos los archivos del bundle
Bundle: 2 archivos, 7 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill voice-note-ingest --agent cline
```

## Qué hace

- Ingesta notas de voz preservando el fraseo exacto sin parafrasear
- Sube el audio original al backend de almacenamiento de gbrain
- Transcribe el audio si no se proporciona transcripción
- Aplica un árbol de decisión para enrutar el contenido a la carpeta correcta
- Crea back-links de línea de tiempo en las páginas de personas/empresas mencionadas

## Cuándo usarla

- El usuario envía un mensaje de audio o nota de voz por cualquier canal (Telegram, memo de voz, adjunto de openclaw)
- Se necesita archivar una idea original, concepto, reflexión personal o pensamiento aleatorio capturado en audio

## Cuándo no

- Maneja una sola nota de voz por ciclo de ingesta; no hace procesamiento por lotes

## Qué la activa

- "Ingiere esta nota de voz"
- "Transcribe y archiva este memo de voz"
- "Guarda esta nota de audio"

## Antes de instalar

- Requiere un backend de almacenamiento gbrain (S3/Supabase/local) y, si no hay transcripción, una herramienta de transcripción como Groq Whisper u OpenAI Whisper.

## Archivos

- SKILL.md — 7 KB
- routing-eval.jsonl — 820 B

## SKILL.md

Reproducido tal cual desde garrytan/gbrain bajo MIT. Esta sección es el documento original y está en inglés.

# voice-note-ingest — Exact-Phrasing Voice Capture

> **Convention:** see [conventions/quality.md](../conventions/quality.md) for
> citation rules, back-link enforcement, and exact-phrasing requirements.
>
> **Convention:** see [_brain-filing-rules.md](../_brain-filing-rules.md) for
> the filing decision protocol.

## Iron Law

The user's **exact words** are the insight. Never paraphrase. Never clean
up. The vivid, unpolished, stream-of-consciousness phrasing captures
something that cleaned-up prose does not. Preserve it in block quotes.
The Analysis section can interpret; the transcript section is sacred.

- ✅ `"The ambition-to-lifespan ratio has never been more fucked"`
- ❌ `User noted the tension between ambition and mortality`

## When to invoke

The user sends an audio or voice message via any channel (Telegram, voice
memo upload, openclaw audio attachment). The host agent typically provides
the transcript text. If not, transcribe it with your host's transcription
tool (Groq Whisper is fast and cheap; OpenAI Whisper works too — segment
audio > 25MB via ffmpeg first).

## The pipeline

```
1. STORE       → Upload original audio to gbrain storage backend
                 (S3 / Supabase Storage / local — pluggable per
                 src/core/storage.ts).
2. TRANSCRIBE  → Use the agent-provided transcript verbatim, OR
                 transcribe the audio yourself (see "When to invoke")
                 if no transcript was supplied.
3. ROUTE       → Apply the decision tree (below) to find the right
                 destination directory.
4. WRITE       → Create / update the destination brain page; preserve the
                 verbatim transcript in a block-quoted "User's Words"
                 section.
5. CROSS-LINK  → For every entity mentioned (person, company), add a
                 timeline back-link from THEIR brain page to THIS one
                 (Iron Law per conventions/quality.md).
```

## Decision tree (where the content goes)

Apply in order. First match wins. If multiple categories apply, file to
the primary directory and cross-link to the others.

1. **Original idea, observation, or thesis** — the user is expressing a
   novel thought, framework, or connection THEY generated.
   → `originals/<slug>.md`. Use the user's vivid language for the slug.

2. **About a world concept they encountered** — a framework or model
   someone else created that the user is referencing.
   → `concepts/<slug>.md`.

3. **About a specific person** — new information, opinion, or observation
   about someone.
   → Update `people/<person>.md` timeline.

4. **About a specific company** — new info about a company.
   → Update `companies/<company>.md` timeline.

5. **A product or business idea** — something that could be built.
   → `ideas/<slug>.md`.

6. **A personal reflection** — therapy-adjacent, emotional, identity.
   → Append to appropriate `personal/<slug>.md`.

7. **None of the above / random thought / doesn't fit cleanly** —
   → `voice-notes/YYYY-MM-DD-<slug>.md` (catch-all).

**Multiple categories?** Create the primary page, then cross-link to all
others. If the voice note covers a person AND a novel idea, create the
originals/ page AND update the person's timeline.

## Brain page format

For ALL voice-note-derived pages, include this skeleton:

```markdown
---
title: "[Title derived from content]"
type: [original | concept | voice-note | ...]
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [voice-note, relevant-tags]
sources:
  voice-note:
    type: voice_note
    storage_path: "[gbrain storage URL or relative path]"
    acquired: YYYY-MM-DD
    acquired_via: "voice note from <channel>"
---

# Title

> Executive summary of what was said and why it matters.

## User's Words

> "Exact transcript, verbatim, preserving every word, hesitation, and verbal
> tic. This is the primary source material. Do not edit."

🔊 [Audio]([gbrain storage URL or relative path])

## Analysis

[What this means, why it matters, connections to other thinking. The
analysis is the agent's interpretation; the transcript above is sacred.]

## See Also

- [Related brain pages with relative links]

---

## Timeline

- **YYYY-MM-DD** | voice note from <channel> — [Brief description]
```

## Citation format

```
[Source: voice note, <channel>, YYYY-MM-DD]
```

Include timestamps when available:

```
[Source: voice note, <channel>, YYYY-MM-DD HH:MM PT]
```

## Naming convention

- Audio files: `YYYY-MM-DD-<brief-slug>.<ext>` (e.g.,
  `2026-04-13-rick-rubin-creative-philosophy.ogg`)
- Brain pages: match the slug of the destination directory.

## Bulk vs. single

This skill handles ONE voice note at a time. Each is its own ingest cycle.
No batching.

## Anti-Patterns

- ❌ **Paraphrasing the transcript.** The exact words are the signal.
- ❌ **Cleaning up hesitations or filler words** ("um", "like", "you
  know"). The texture matters.
- ❌ **Creating a page with no entity cross-links** when people/companies
  were mentioned. Iron Law fail.
- ❌ **Skipping the audio storage step.** Always upload the original; the
  brain page has a `🔊 [Audio]` link back to it.

## Related skills

- `skills/signal-detector/SKILL.md` — same exact-phrasing pattern for
  text-channel idea capture
- `skills/idea-ingest/SKILL.md` — for typed-text idea ingestion
- `skills/conventions/quality.md` — citation + back-link rules

## Contract

This skill guarantees:

- Routing matches the canonical triggers in the frontmatter.
- Output written under the directories listed in `writes_to:` (when applicable).
- Conventions referenced (`quality.md`, `brain-first.md`, `_brain-filing-rules.md`) are followed.
- Privacy contract preserved: no real names, no fork-specific filesystem path literals, no upstream-fork references.

The full behavior contract is documented in the body sections above; this section exists for the conformance test.

## Output Format

The skill's output shape is documented inline in the body sections above (see "Output", "Brain page format", or equivalent). The literal section header here exists for the conformance test (`test/skills-conformance.test.ts`).

## Dónde encaja

- Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales.
- Creador: [garrytan](https://skillsagentes.com/creators/garrytan.md) — 134 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Setup](https://skillsagentes.com/skills/garrytan/gbrain/setup.md): Configura GBrain con auto-aprovisionamiento de Supabase o PGLite, inyección en AGENTS.md y primera importación.
- [Maintain](https://skillsagentes.com/skills/garrytan/gbrain/maintain.md): Chequeos de salud del brain: aplicación de back-links, auditoría de citas, validación de filing, detección de info obsoleta, páginas huérfanas y benchmarks.
- [Schema Unify](https://skillsagentes.com/skills/garrytan/gbrain/schema-unify.md): Migra un brain de gbrain-base a la taxonomía de 14 tipos canónicos de gbrain-base-v2 usando gbrain onboard --check y el handler Minion unify-types.
- [Retrieval Reflex](https://skillsagentes.com/skills/garrytan/gbrain/retrieval-reflex.md): Cuándo y qué recuperar: abre la página del brain de una entidad relevante antes de responder desde memoria.
- [Minion Orchestrator](https://skillsagentes.com/skills/garrytan/gbrain/minion-orchestrator.md): Skill unificado de Minions para jobs deterministas de shell y orquestación de subagentes LLM: cola durable, observable y controlable, más la doctrina de ejecución durable para operaciones largas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)