# Soul Audit

> Vuelve a correr o profundiza la entrevista de identidad del agente, guardando respuestas verbatim en state/interview.json y re-renderizando SOUL.md, USER.md, ACCESS_POLICY.md y HEARTBEAT.md.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/soul-audit
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/soul-audit.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 10 días
Coste de contexto: 133 tok instalada, 1.4k tok al activarse, 1.4k tok con todos los archivos del bundle
Bundle: 1 archivo, 6 KB
Permisos que pide: shell

## 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 soul-audit --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill soul-audit --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill soul-audit --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill soul-audit --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill soul-audit --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill soul-audit --agent cline
```

## Qué hace

- Actualiza la identidad del agente mediante una entrevista interactiva, guardando respuestas en el banco compartido state/interview.json
- Ejecuta `gbrain bootstrap interview --set/--show/--confirm` para registrar y confirmar respuestas verbatim del usuario
- Re-renderiza SOUL.md, USER.md, ACCESS_POLICY.md, HEARTBEAT.md o AGENTS.md con `gbrain bootstrap render --only <FILE> --force`
- Corre un ritual de lectura de confirmación antes de renderizar, con backup automático en .gbrain-bootstrap-backups/

## Cuándo usarla

- Se quiere volver a hacer o profundizar la entrevista de identidad del agente en cualquier momento después del bootstrap
- El usuario quiere cambiar la personalidad, el nombre, el propósito o el tono del agente
- Hay que actualizar límites de acceso, cadencia de heartbeat o el perfil del usuario principal

## Cuándo no

- No genera archivos desde cero ni escribe la prosa de identidad por sí mismo
- No se debe usar para editar SOUL.md/USER.md directamente a mano

## Qué la activa

- "Quiero hacer un soul audit de mi agente"
- "Cambia la personalidad de mi agente"
- "Actualiza quién soy en mi agente"
- "Configura los límites de acceso a mi brain"
- "Vuelve a calibrar el tono de respuesta del agente"

## Antes de instalar

- Requiere el CLI `gbrain` y que exista el banco de respuestas (o correr `gbrain bootstrap interview --init` si el workspace nunca corrió bootstrap).

## Archivos

- SKILL.md — 6 KB

## SKILL.md

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

# Soul Audit — Agent Identity Builder (re-run / deepen surface)

Update the agent's identity through an interactive interview, any time after
bootstrap. This skill does NOT generate files from scratch and does NOT write
identity prose itself: it records the user's answers into the shared answer
bank, then lets the bootstrap render engine produce the files. That keeps one
source of truth — `state/interview.json` — no matter which surface (first-boot
bootstrap, this skill, a future re-audit) collected the answers.

**IMPORTANT:** Content comes from the USER'S OWN ANSWERS, recorded verbatim.
NEVER invent, embellish, or default an identity answer. The render gate
structurally refuses until required answers exist and were read back and
confirmed by the human.

## Contract

This skill guarantees:
- Answers land in the shared bank via `gbrain bootstrap interview --set KEY "value"`
  (verbatim, one key per answer; `--skip KEY` records an explicit decline).
- The read-back ritual runs before any render: `--show` the full answer set,
  mirror it to the user, then `--confirm <hash>` with the hash `--status`
  printed. Confirming a set the user never saw fails by design.
- Files re-render through the ONE render path:
  `gbrain bootstrap render --only SOUL.md --force` (repeat per file). `--force`
  backs the old file up under `.gbrain-bootstrap-backups/<ts>/` first — nothing
  is clobbered without a recoverable copy.
- Each phase is independent and re-runnable; updating one answer and
  re-rendering one file is a complete, valid run.

## The command loop

```
gbrain bootstrap interview --show            # what the bank holds now (start here)
gbrain bootstrap interview --set KEY "..."   # record one updated answer, verbatim
gbrain bootstrap interview --skip KEY        # explicit decline for an optional key
gbrain bootstrap interview --status          # gate + read-back hash
gbrain bootstrap interview --confirm <hash>  # after reading answers back to the user
gbrain bootstrap render --only SOUL.md --force
```

Render targets: `SOUL.md`, `USER.md`, `ACCESS_POLICY.md`, `HEARTBEAT.md`,
`AGENTS.md` (re-render whichever files the changed keys feed).

## Phases (each independent, each re-runnable)

### Phase 1: Identity Interview
Ask: "What is this agent to you? Research partner? Executive assistant? Thinking
partner? All of the above?"
Keys: `AGENT_NAME`, `AGENT_PURPOSE`, `SOUL_RELATIONSHIP`. Renders: SOUL.md.

### Phase 2: Vibe Calibration
Show 3-4 communication style examples:
- **Formal:** "I've prepared a comprehensive analysis of the situation..."
- **Direct:** "Here's what's happening. Three things matter."
- **Technical:** "The root cause is in the connection pooling. Here's the fix."
- **Casual:** "Yeah so basically the thing is broken because X. Easy fix."
Ask which feels right; also ask for a reply that made them wince and why.
Keys: `VOICE_REGISTER`, `SOUL_WINCE`, `SOUL_MODE_DEFAULT`. Renders: SOUL.md.

### Phase 3: Mission Mapping
Ask: "What are your top 3-5 goals? What are you trying to accomplish?"
Keys: `AGENT_TOP_JOBS`, `SOUL_GOOD_OUTPUT`, `SOUL_WORLDVIEW`. Renders: SOUL.md,
AGENTS.md.

### Phase 4: User Profile
Ask: "Tell me about yourself. What do you do? What are you working on? Who are
the key people in your world?"
Keys: `PRINCIPAL_NAME`, `PRINCIPAL_CONTEXT`, `PRINCIPAL_TIMEZONE`. Renders:
USER.md.

### Phase 5: Boundaries
Ask: "Who should have access to your brain? Are there people who should see some
but not all? Anyone to keep out entirely?"
Key: `ACCESS_TIERS` (and review the standing-disclosure sections). Renders:
ACCESS_POLICY.md.

### Phase 6: Operational Cadence
Ask: "How often should the agent check in? Morning briefing? End of day summary?
What recurring jobs do you want?"
Keys: `HEARTBEAT_CADENCE`, `QUIET_HOURS`. Renders: HEARTBEAT.md. Jobs ship
disabled — enable one at a time after a manual dry run (the ritual is in the
rendered file).

Run `gbrain bootstrap interview --init` first if the bank does not exist yet
(a workspace that never ran bootstrap); it prints the full question list.

## Output Format

Report exactly what changed: which keys were updated, which files re-rendered,
and where the backups landed. Example: "Soul audit: updated VOICE_REGISTER +
SOUL_WINCE, re-rendered SOUL.md (backup in .gbrain-bootstrap-backups/...).
Re-run any phase anytime."

## Anti-Patterns

- Writing identity prose yourself instead of recording the user's words into
  the bank (the render engine is the only author of these files)
- Hand-editing SOUL.md/USER.md directly — the next render overwrites it; edit
  the ANSWER, then re-render
- Confirming a read-back hash for answers the user never saw
- Making the audit mandatory or asking all 6 phases in one go (overwhelming;
  each is independent — momentum beats completeness)
- Shipping pre-filled identity content (privacy violation)
- Not offering to re-run individual phases

## 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)