Agent skill

Soul Audit

by garrytan in garrytan/gbrain

Re-run or deepen the agent's identity interview. An agent skill from garrytan/gbrain.

MITAuto-check passed

Install Soul Audit

skills CLI
$ npx skills add garrytan/gbrain --skill soul-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install garrytan/gbrain soul-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/garrytan/gbrain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/soul-audit .claude/skills/soul-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
soul-audit
GitHub stars
31k
Token cost
~1.6k tokens
SKILL.md length
693 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Re-run or deepen the agent's identity interview. An agent skill from garrytan/gbrain.

  • Works in 6 steps: Identity Interview → Vibe Calibration → Mission Mapping → …
  • SKILL.md covers Contract, The command loop, Phases (each independent, each… and Output Format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Soul Audit is an agent skill from garrytan/gbrain. Re-run or deepen the agent's identity interview. Drives the SHARED bootstrap answer bank (state/interview.json) via gbrain bootstrap interview --set/--show/--confirm, then re-renders the identity files with gbrain bootstrap render --only <FILE --force. One answer store, two surfaces: first-boot bootstrap and this re-run skill write the same bank, so an updated answer flows into SOUL.md, USER.md, ACCESSPOLICY.md, and HEARTBEAT.md without hand-editing rendered files. Every answer is the user's own words — never…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Garry's Opinionated OpenClaw/Hermes Agent Brain. The licence is MIT.

Example prompts

  • “/soul-audit”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Identity Interview
  2. Vibe Calibration
  3. Mission Mapping
  4. User Profile
  5. Boundaries
  6. Operational Cadence

What it can do on your machine

Read from SKILL.md and the folder at commit f250a51. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Soul Audit loads about 1.6k tokens when it runs. Until then it costs about 135 tokens; SKILL.md has 693 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~135
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from garrytan/gbrain at commit f250a51, republished under its MIT licence (© garrytan). 693 words, ~1,553 tokens.

Download SKILL.mdSave it as .claude/skills/soul-audit/SKILL.md (or your agent's skills folder).
name
soul-audit
description
Re-run or deepen the agent's identity interview. Drives the SHARED bootstrap answer bank (state/interview.json) via `gbrain bootstrap interview --set/--show/--confirm`, then re-renders the identity files with `gbrain bootstrap render --only <FILE> --force`. One answer store, two surfaces: first-boot bootstrap and this re-run skill write the same bank, so an updated answer flows into SOUL.md, USER.md, ACCESS_POLICY.md, and HEARTBEAT.md without hand-editing rendered files. Every answer is the user's own words — never invented.
version
2.0.0
triggers
soul audit, customize agent, who am I, set up identity, change my agent's personality
tools
shell
mutating
true

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.

Show full SKILL.md (294 more words)Show less
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."

When it fails

Follow the agent operator protocol for any gbrain error code, exit code, [AGENT] block or notice block. Specific to this skill:

  • gbrain bootstrap interview --confirm <hash> fails: the hash must come from a read-back the user actually saw. Re-run gbrain bootstrap interview --status, read the answers back, and confirm only with the user's agreement.
  • Rendering refuses because required answers are missing: ask the user for them; never fill identity answers yourself.

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

© garrytan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/soul-audit of garrytan/gbrain.

Open the folder on GitHubat commit f250a51

Compare with similar skills

Soul Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Soul Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Soul Audit this skillgarrytan/gbrain31k—~1.6kAutomated safety check: PassMIT
Interviewalirezarezvani/claude-skills28k—~1.1kAutomated safety check: PassMIT
Interviewcodewhale-hq/Codewhale41k—~232Automated safety check: PassMIT
Interview Meaddyosmani/agent-skills105k6 repos~3.8kAutomated safety check: PassMIT
Interview Prepreactive-resume/reactive-resume44k—~10kAutomated safety check: PassMIT
Interview Coachsickn33/agentic-awesome-skills47k2 repos~751Automated safety check: PassMIT

Similar skills

  • Interview

    alirezarezvani/claude-skills

    Phase 1 of building a Claude Managed Agent — interview the founder about the one job the agent should do, then produce a build sheet (CMA primitives table + v1/v2 deferrals + eval plan) WITHOUT…

    28k GitHub stars~1.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Interview

    codewhale-hq/Codewhale

    Ask one useful structured question at a time only when material product/implementation choices are genuinely missing; remember answers and produce a brief/spec.

    41k GitHub stars~232 tokensUpdated today
    Auto-check passed
  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    105k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed
  • Interview Prep

    reactive-resume/reactive-resume

    Prepares the user for a specific interview from their real experience.

    44k GitHub stars~10k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Interview Coach

    sickn33/agentic-awesome-skills

    Full job search coaching system — JD decoding, resume, storybank, mock interviews, transcript analysis, comp negotiation.

    47k GitHub starsUsed in 2 repos~751 tokens
    Business, Finance & HRAuto-check passed
  • Mock Interview

    reactive-resume/reactive-resume

    Runs a mock interview for a specific job description. An agent skill from reactive-resume/reactive-resume.

    44k GitHub stars~11k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from garrytan/gbrain

All 47 skills in this repo
  • Traces a factual error the user points out back to its source (a brain page, a memory file, SOUL.md or USER.md, or a hallucination) and fixes that source instead of just noting the correction.

    31k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Searches and writes a company-wide knowledge brain through the gbrain CLI, so durable decisions and facts about people, projects and history stay findable beyond one session.

    31k GitHub stars~875 tokensUpdated today
    Auto-check passed
  • Idea Ingest

    garrytan/gbrain

    Ingest links, articles, tweets, and ideas into the brain. An agent skill from garrytan/gbrain.

    31k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Sends what your notes already know about a topic to Perplexity, so the cited web search reports only what is new, such as entity updates or deal changes.

    31k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Schema Unify

    garrytan/gbrain

    Migrate a brain from gbrain-base (or any pack) to gbrain-base-v2's 14-canonical-type taxonomy via gbrain onboard --check + the unify-types Minion handler.

    31k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Skillpack Check

    garrytan/gbrain

    Run gbrain skillpack-check to produce an agent-readable JSON health report for the gbrain install.

    31k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Soul Audit

What does Soul Audit do?

Re-run or deepen the agent's identity interview. An agent skill from garrytan/gbrain. Soul Audit is an agent skill from garrytan/gbrain. Re-run or deepen the agent's identity interview.

How do I install Soul Audit in Claude Code?

Run `npx skills add garrytan/gbrain --skill soul-audit -a claude-code`. Or copy the skill folder (skills/soul-audit in garrytan/gbrain) into .claude/skills/soul-audit in your project. Claude Code loads it when a task matches its description.

How do I install Soul Audit in Codex?

Run `npx skills add garrytan/gbrain --skill soul-audit -a codex`. Or copy the skill folder (skills/soul-audit in garrytan/gbrain) into .agents/skills/soul-audit in your project. Codex loads it when a task matches its description.

Can I use Soul Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add garrytan/gbrain --skill soul-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/soul-audit, .gemini/skills/soul-audit, .github/skills/soul-audit and .opencode/skills/soul-audit in your project.

What does Soul Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: Soul Audit is instructions for the agent only.

Does Soul Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Soul Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Soul Audit use?

Soul Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Soul Audit use?

About 1.6k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Soul Audit?

Skills that share tags, products or a category with Soul Audit: Interview (alirezarezvani/claude-skills, 28k stars), Interview (codewhale-hq/Codewhale, 41k stars), Interview Me (addyosmani/agent-skills, 105k stars) and Interview Prep (reactive-resume/reactive-resume, 44k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Soul Audit?

garrytan (a GitHub user) maintains it in garrytan/gbrain, which has 30,736 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 10, 2026.

Source: garrytan/gbrain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.