Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy.

MITAuto-check passedDevelopment

Install Soul

skills CLI
$ npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill soul -a claude-code

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

GitHub CLI
$ gh skill install Soul-Brews-Studio/arra-oracle-skills-cli soul --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/Soul-Brews-Studio/arra-oracle-skills-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/soul .claude/skills/soul && 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
GitHub stars
123
Token cost
~1.3k tokens
SKILL.md length
574 words
Files
2 (incl. scripts)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy.

  • Works in 5 steps: resolve the Oracle → see what it carries (writes nothing) → link the skills → …
  • User says soul NAME
  • SKILL.md covers Step 1 — resolve the Oracle, Step 2 — see what it carries…, Step 3 — link the skills and Step 4 — load the soul and the…, plus 3 more sections
  • Runs TypeScript scripts from its folder; calls bun

What it does

Soul is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy. Reads the Oracle's resonance/identity files, symlinks every skill in its .claude/skills/ into this repo (git-excluded, recorded in a manifest), and indexes its learnings. "Many bodies, one soul": one session can carry Neo, then Pulse. Use when user says "soul NAME", "bring ORACLE here", "bring ORACLE soul", "แปลงร่างเป็น ORACLE", "become ORACLE", or "soul off NAME". Do NOT use to create an Oracle (use…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/soul.ts`).

It sits in Development. It works with Git. The repository describes itself as: Install Oracle skills to Claude Code, OpenCode, Cursor, and 12+ AI coding agents. The licence is MIT.

When your agent uses it

  • User says soul NAME
  • Bring ORACLE here
  • Bring ORACLE soul
  • แปลงร่างเป็น ORACLE

Example prompts

  • “Many bodies, one soul”
  • “soul NAME”
  • “bring ORACLE here”
  • “/soul”

Requirements

  • Node.js

Workflow steps

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

  1. resolve the Oracle
  2. see what it carries (writes nothing)
  3. link the skills
  4. load the soul and the expertise
  5. say who is here

What it can do on your machine

Read from SKILL.md and the folder at commit 9feea09. 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

    Ships 1 file in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • bun

    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 loads about 1.3k tokens when it runs. Until then it costs about 159 tokens; SKILL.md has 574 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Soul-Brews-Studio/arra-oracle-skills-cli at commit 9feea09, republished under its MIT licence (© Soul-Brews-Studio). 574 words, ~1,279 tokens.

Download SKILL.mdSave it as .claude/skills/soul/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
soul
description
Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy. Reads the Oracle's resonance/identity files, symlinks every skill in its .claude/skills/ into this repo (git-excluded, recorded in a manifest), and indexes its learnings. "Many bodies, one soul": one session can carry Neo, then Pulse. Use when user says "soul NAME", "bring ORACLE here", "bring ORACLE soul", "แปลงร่างเป็น ORACLE", "become ORACLE", or "soul off NAME". Do NOT use to create an Oracle (use /awaken), to link a vault (use /psi), or to wear several souls for one question (use /oracle-prism or /round-table).
argument-hint
<oracle-path | org/name | name> [--show] · off <name>

/soul — bring an Oracle, whole

Many bodies, one soul. The form can move; the soul stays in its own repo.

An Oracle is three things, and /soul brings all three — by reference, so the Oracle's own repo stays the single source and every fix there reaches every guest:

PartLives inBrought by
Soul — who it isψ/memory/resonance/<name>.md, oracle.md, SOUL.md, IDENTITY.md, CLAUDE.md identityreading them, in that order
Skills — what it can do.claude/skills/*/SKILL.mda symlink per skill in this repo's .claude/skills/
Expertise — what it learnedψ/memory/learnings/*.mdan index of titles; read a file when its topic comes up
text
guest/.claude/skills/pulse-board  ──symlink──▶  pulse/.claude/skills/pulse-board
guest/.claude/souls/pulse.json    manifest of the links this skill made
guest/.git/info/exclude           both excluded — never in the tracked .gitignore

SKILL_DIR is the base directory printed above this skill.

Step 1 — resolve the Oracle

The argument is a path, or a name for maw locate (if you have maw):

bash
ARG="<argument>"
if [ -d "$ARG" ]; then ROOT=$(cd "$ARG" && pwd)
else ROOT=$(maw locate "$ARG" --path 2>/dev/null)
fi
echo "root: ${ROOT:-NOT FOUND}"

If maw locate prints "matches N oracles", it lists org/name candidates — show them and ask which one; never pick. Empty → say so and stop. No filesystem search.

Step 2 — see what it carries (writes nothing)

bash
bun "$SKILL_DIR/scripts/soul.ts" show "$ROOT"

It prints the soul files, every skill with what will happen to it, and the newest learnings:

MarkMeaning
+will be linked
=already linked here
~read-and-follow — a skill with that name already exists in this repo or in ~/.claude/skills/. Linking would make two skills with one name, so it is not linked; to use the Oracle's version, Read the printed SKILL.md path and follow it

With --show, stop here.

bash
bun "$SKILL_DIR/scripts/soul.ts" link "$ROOT"

Relative symlinks, a manifest at .claude/souls/<name>.json, and lines appended to .git/info/exclude — the repo's tracked files do not change. If it reports ⚠ TRACKED already, stop and tell the human: those paths are committed in this repo.

New skills usually appear in the session's skill list without a restart (Claude Code watches skill folders). If they don't, the human runs /reload-plugins.

Step 4 — load the soul and the expertise

Read every soul file show listed, in order. Then keep the learnings index in mind: when the work touches a topic in it, Read that learning before acting — that is the Oracle's experience, not a guess.

Step 5 — say who is here

text
<Name> here — soul, <N> skills and <M> learnings from <ROOT> — working in <repo>.
Show full SKILL.md (228 more words)Show less

Working as a visiting Oracle

  • Borrowed skills run from their home. Many skills assume their own repo as the working directory (./scripts, config files, just). When a linked skill refers to repo-relative paths, resolve its home with realpath on the skill's base directory and go up three levels (skills/<s> → .claude → repo), and run those commands there — in a subshell, never by changing the session's cwd. Commands about this repo still run here.
  • This repo's rules win. The guest's AGENTS.md / CLAUDE.md override the visitor's habits on everything they cover.
  • Memory stays with the guest's caretaker. If ψ links to a vault, that is where retros and learnings go. A visitor does not write into its own home repo from here unless the human asks.
  • Rule 6. It is still one AI wearing a form. Say so when asked; never claim to be the Oracle's own running session. For its real view, ask it (/talk-to).

Changing souls

bash
bun "$SKILL_DIR/scripts/soul.ts" off <name>

Removes only the symlinks its manifest lists, and only while each still points into that Oracle — real folders and other links are never touched. Exclude lines stay (harmless). Then /soul <next>.

What off cannot do: unread the soul. The old soul's files remain in this conversation's context. For a clean change of identity, run off, then start a new session with /soul <next>; within one session, say plainly which soul is speaking now.

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

Files

SKILL.md and 1 other file (scripts) in skills/soul of Soul-Brews-Studio/arra-oracle-skills-cli.

  • SKILL.md
  • scripts/soul.ts

Open the folder on GitHubat commit 9feea09

Compare with similar skills

Soul 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Soul this skillSoul-Brews-Studio/arra-oracle-skills-cli123—~1.3kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Finishing A Development Branchfarm-fe/farm5.6k35 repos~1.8kAutomated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 35 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed

More from Soul-Brews-Studio/arra-oracle-skills-cli

All 31 skills in this repo
  • Dig

    Soul-Brews-Studio/arra-oracle-skills-cli

    Mine Claude Code sessions — timeline, gaps, repo attribution, session history.

    123 GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed
  • Forward

    Soul-Brews-Studio/arra-oracle-skills-cli

    Hand off the current session to the next one. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check passed
  • Project

    Soul-Brews-Studio/arra-oracle-skills-cli

    Clone and track external repos. An agent skill from Soul-Brews-Studio/arra-oracle-skills-cli.

    123 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed
  • Round Table

    Soul-Brews-Studio/arra-oracle-skills-cli

    Convene a Round Table (โต๊ะกลม): 3–8 souls — persona files, Oracles, or real people's DNA — debate ONE stakes-bearing decision over exactly 4 rounds (OPEN, DEEPEN, CONVERGE, VOTE), one subagent per…

    123 GitHub stars~2.1k tokensUpdated 8 days ago
    Auto-check passed
  • Trace

    Soul-Brews-Studio/arra-oracle-skills-cli

    Find projects, code, and knowledge across git history, repos, docs, and Oracle.

    123 GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check passed
  • Recap

    Soul-Brews-Studio/arra-oracle-skills-cli

    Session orientation and awareness — retro summaries, handoffs, git state, focus.

    123 GitHub stars~2.7k tokensUpdated 8 days ago
    Auto-check passed

Works with

Categories

Questions about Soul

What does Soul do?

Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy. Soul is an agent skill from Soul-Brews-Studio/arra-oracle-skills-cli. Bring an Oracle into the current repo — its soul, ALL its skills and its expertise — by link, never by copy.

When should I use Soul?

Soul fits situations like: user says soul NAME; bring ORACLE here; bring ORACLE soul; แปลงร่างเป็น ORACLE.

How do I install Soul in Claude Code?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill soul -a claude-code`. Or copy the skill folder (skills/soul in Soul-Brews-Studio/arra-oracle-skills-cli) into .claude/skills/soul in your project. Claude Code loads it when a task matches its description.

How do I install Soul in Codex?

Run `npx skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill soul -a codex`. Or copy the skill folder (skills/soul in Soul-Brews-Studio/arra-oracle-skills-cli) into .agents/skills/soul in your project. Codex loads it when a task matches its description.

Can I use Soul 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 Soul-Brews-Studio/arra-oracle-skills-cli --skill soul -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, .gemini/skills/soul, .github/skills/soul and .opencode/skills/soul in your project.

What does Soul need to run?

Going by SKILL.md and its folder, Soul needs TypeScript for the scripts in its folder and the command-line tools its instructions call (bun). Our summary lists: Node.js.

Does Soul 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 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Soul use?

Soul 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 use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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?

Skills that share tags, products or a category with Soul: Finishing a Development Branch (obra/superpowers, 297k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Finishing A Development Branch (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Soul?

Soul-Brews-Studio (a GitHub organization) maintains it in Soul-Brews-Studio/arra-oracle-skills-cli, which has 123 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 3, 2026.

Source: Soul-Brews-Studio/arra-oracle-skills-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.