speak

Step 0: Install Claude Code (if not installed)

```bash

curl -fsSL https://claude.ai/install.sh | bash

```

Step 1: Tell Claude to run, then restart and /awaken:

```bash

# Install oracle-skills

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

# Setup permissions (run in your Oracle repo after restart)

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

```

---

One Command

```bash

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

```

---

Manual Steps

```

# Requirements: bash/zsh (macOS/Linux) or Git Bash (Windows)

# 1. Check & install bun

which bun || curl -fsSL https://bun.sh/install | bash

# 2. Check & install ghq (for /learn and /trace)

which ghq || brew install ghq # macOS

# Linux/Windows: go install github.com/x-motemen/ghq@latest

# 3. Install oracle-skills

~/.bun/bin/bunx --bun \

oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#v1.5.36 \

install -g -y

# 4. Setup permissions in your Oracle repo (run BEFORE claude .)

# cd /path/to/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)", "Bash(source ~/.bashrc)",

"Bash(export PATH=\"$HOME/.bun/bin:$PATH\")",

"Bash(ψ/)", "Bash(psi/)",

"Skill(learn)", "Skill(trace)", "Skill(awaken)",

"Skill(rrr)", "Skill(recap)", "Skill(project)"

]

}

}

EOF

# 5. Create alias (add to ~/.bashrc or ~/.zshrc)

alias oracle-skills='~/.bun/bin/bunx --bun \

oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#v1.5.36'

# 6. Usage (with alias)

oracle-skills install -g -y

oracle-skills list -g

oracle-skills uninstall -g -y

# Or full command

~/.bun/bin/bunx --bun oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#v1.5.36 install -g -y

~/.bun/bin/bunx --bun oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#v1.5.36 list -g

~/.bun/bin/bunx --bun oracle-skills@github:Soul-Brews-Studio/oracle-skills-cli#v1.5.36 uninstall -g -y

# Flags

# -g Global (user) directory

# -y Skip prompts

# -a Target agent(s)

# -s Specific skill(s)

```

Then run claude "/awaken" to create a new Oracle ([example](https://github.com/Soul-Brews-Studio/phukhao-oracle)).

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

| # | Skill | Type | Description |

|---|-------|------|-------------|

| 1 | learn | skill + subagent | Explore a codebase |

| 2 | rrr | skill + subagent | Create session retrospective with AI diary |

| 3 | trace | skill + subagent | Find projects across git history, repos |

| - | | | |

| 4 | deep-research | skill + code | Deep Research via Gemini |

| 5 | gemini | skill + code | Control Gemini via MQTT WebSocket |

| 6 | physical | skill + code | Physical location awareness from FindMy |

| 7 | project | skill + code | Clone and track external repos |

| 8 | recap | skill + code | Fresh-start orientation—adaptive synthesis |

| 9 | schedule | skill + code | Query schedule.md using DuckDB markdown |

| 10 | skill-creator | skill + code | Create new skills with Oracle philosophy |

| 11 | speak | skill + code | Text-to-speech using edge-tts or macOS say |

| 12 | watch | skill + code | Learn from YouTube videos |

| - | | | |

| 13 | awaken | skill | Guided Oracle birth |

| 14 | birth | skill | Prepare birth props for a new Oracle repo |

| 15 | feel | skill | Log emotions with optional structure |

| 16 | forward | skill | Create handoff + enter plan mode for next |

| 17 | fyi | skill | Log information for future reference |

| 18 | merged | skill | Post-Merge Cleanup |

| 19 | oracle-family-scan | skill | oracle-family-scan skill |

| 20 | oracle-soul-sync-calibrate-update | skill | Sync Oracle instruments with the family |

| 21 | philosophy | skill | Display Oracle philosophy principles |

| 22 | ralph-loop-soulbrews | skill | Self-referential AI loops |

| 23 | retrospective | skill | Create session retrospective with AI diary |

| 24 | standup | skill | Daily standup check |

| 25 | where-we-are | skill | Session awareness - what we're doing now |

| 26 | who-we-are | skill | Know ourselves |

| 27 | worktree | skill | Git worktree for parallel work |

Generated: 2026-02-04 08:28:22 UTC

| Agent | Project Path | Global Path |

|-------|--------------|-------------|

| Claude Code | .claude/skills/ | ~/.claude/skills/ |

| OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ |

| Codex | .codex/skills/ | ~/.codex/skills/ |

| Cursor | .cursor/skills/ | ~/.cursor/skills/ |

| Amp | .agents/skills/ | ~/.config/agents/skills/ |

| Kilo Code | .kilocode/skills/ | ~/.kilocode/skills/ |

| Roo Code | .roo/skills/ | ~/.roo/skills/ |

| Goose | .goose/skills/ | ~/.config/goose/skills/ |

| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ |

| Antigravity | .agent/skills/ | ~/.gemini/antigravity/skills/ |

| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ |

| Clawdbot | skills/ | ~/.clawdbot/skills/ |

| Droid | .factory/skills/ | ~/.factory/skills/ |

| Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ |

> "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.

• [oracle-v2](https://github.com/Soul-Brews-Studio/oracle-v2) - MCP Memory Layer (Oracle brain)
• [Soul Brews Plugin Marketplace](https://github.com/Soul-Brews-Studio/plugin-marketplace) - Source of Oracle skills
• [Agent Skills Specification](