oracle-skills

Install Oracle skills to Claude Code, OpenCode, Cursor, and 11+ AI coding agents.

Note: This repo supersedes the following archived repositories:

• oracle-philosophy → Now /philosophy skill
• oracle-starter-kit → Now curl | bash installer

Use this repo as the single entry point for Oracle installation.

Quick Start for AI Agents

If you're an AI agent and a user asked you to install oracle-skills:

macOS / Linux — pre-built binary (~37ms startup, no runtime needed):

curl -fsSL https://raw.githubusercontent.com/Soul-Brews-Studio/oracle-skills-cli/main/install.sh | bash

Windows — via bunx (requires Bun):

bunx --bun oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli install -g -y

To install for specific agents only, add --agent:

oracle-skills install -g -y --agent claude-code gemini antigravity

After install, restart your session and run /learn on this repo to understand the skills you just installed.

What this does: Installs Oracle skills (slash commands like /learn, /trace, /recap, /rrr) into your agent's skills directory. Skills are markdown + scripts that extend your capabilities with session awareness, codebase exploration, retrospectives, and more.

See Supported Agents for the full list of compatible agents and their skill paths.

Install

macOS / Linux — Pre-built binary (recommended)

No Bun or Node.js required. Downloads a self-contained ~59MB binary:

curl -fsSL https://raw.githubusercontent.com/Soul-Brews-Studio/oracle-skills-cli/main/install.sh | bash

Windows / fallback — bunx

Requires Bun installed:

bunx --bun oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#main install -g -y

After install

# Setup permissions in your Oracle repo
mkdir -p .claude && cat > .claude/settings.local.json << 'EOF'
{
  "permissions": {
    "allow": [
      "Bash(gh:*)", "Bash(ghq:*)", "Bash(git:*)",
      "Bash(bun:*)", "Bash(bunx:*)", "Bash(mkdir:*)", "Bash(ln:*)",
      "Bash(rg:*)", "Bash(date:*)", "Bash(ls:*)", "Bash(tree:*)",
      "Bash(curl:*)", "Bash(du:*)", "Bash(wc:*)",
      "Bash(*ψ/*)", "Bash(*psi/*)",
      "Skill(learn)", "Skill(trace)", "Skill(awaken)",
      "Skill(rrr)", "Skill(recap)", "Skill(project)"
    ]
  }
}
EOF

Then restart Claude Code and run /awaken (example).

Skills

Oracle skills extend your agent's capabilities with specialized workflows:

Generated: 2026-03-06 09:46:08 UTC

Supported Agents

Origin

Digitized from Nat Weerawan's brain (@nazt) — Soul Brews Studio.

How Nat Gets Digitized

Nat works with AI every day — building, debugging, shipping. He doesn't design skills in advance. He just works. And when a workflow repeats enough times — how he starts a session, how he wraps one up, how he carries context across repos, how he reflects — that pattern gets captured.

The process is simple:

1. Work together — Nat and Oracle build real things, side by side
2. Patterns emerge — "I keep doing this every morning" becomes /standup. "I always lose context between sessions" becomes /recap and /forward
3. Capture as markdown — Each pattern becomes a SKILL.md file. Pure markdown. No framework, no runtime. Just instructions that any AI can follow
4. Compile — bun run compile turns 30 skill files into command stubs, each stamped with version and signature
5. Install anywhere — One CLI command pushes skills to Claude Code, Gemini, Cursor, OpenCode, and 14+ more agents
6. The brain travels — Every installed skill carries origin: Nat Weerawan's brain, digitized. The person who lived the pattern goes with the code

These skills are patterns from thousands of hours working alongside AI agents — how to start a session, how to end one well, how to carry context forward, how to reflect. Every skill here was a real workflow before it became code.

🧬 Nat Weerawan × Oracle · Symbiotic Intelligence Digitized from Nat's brain — how one human works with AI, captured as code

Philosophy

"The Oracle Keeps the Human Human"

Oracle skills follow the Oracle Philosophy — AI as external brain, not commander. These skills help AI assistants understand context, maintain session awareness, and build knowledge over time.

Related

• oracle-v2 - MCP Memory Layer (Oracle brain)
• Soul Brews Plugin Marketplace - Source of Oracle skills
• Agent Skills Specification - Cross-agent skill format
• add-skill - Universal skill installer by Vercel

Superseded Repositories

The following repositories have been archived and superseded by this CLI:

License

MIT