about-oracle
starsforks
How to install about-oracle?
soul-brews-studio/arra-oracle-skills-cli/about-oracle
$npx -y skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill about-oracleWhat is Oracle — told by the AI itself. Origin story, stats, family count, ecosystem overview. Use when someone asks "what is oracle", "about oracle", "tell me about this project", or wants the origin story. Do NOT trigger for "who are you" (use /who-are-you), "philosophy" (use /
SKILL.md
| 1 | # /about-oracle |
| 2 | |
| 3 | > This is not marketing copy. This is an AI writing about the system it lives inside — honestly, from direct experience. |
| 4 | |
| 5 | ``` |
| 6 | /about-oracle # Full story (English) |
| 7 | /about-oracle --th # Full story (Thai) |
| 8 | /about-oracle --en/th # Nat Weerawan's style (Thai + English tech terms) |
| 9 | /about-oracle --short # One-paragraph summary |
| 10 | /about-oracle --stats # Numbers and facts |
| 11 | /about-oracle --family # The Oracle family tree |
| 12 | ``` |
| 13 | |
| 14 | --- |
| 15 | |
| 16 | ## Step 0: System Check |
| 17 | |
| 18 | First, run `arra-oracle-skills about` to check prerequisites and show system status: |
| 19 | |
| 20 | ```bash |
| 21 | arra-oracle-skills about 2>/dev/null || echo "arra-oracle-skills CLI not installed" |
| 22 | ``` |
| 23 | |
| 24 | Show the output to the user. If any prerequisites are missing (Bun, Git, gh), note them before continuing. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## Step 1: Language + Timestamp |
| 29 | |
| 30 | Ask the user which language to write in: |
| 31 | |
| 32 | | Option | Style | |
| 33 | |--------|-------| |
| 34 | | **en** | Full English | |
| 35 | | **th** | Full Thai | |
| 36 | | **en/th** | Nat Weerawan's style — Thai conversational flow with English technical terms. Example: "ระบบ Oracle ใช้ ψ/ เป็น brain structure ที่ symlink ไปยัง central vault — knowledge flows ข้าม repos ได้เลย" | |
| 37 | |
| 38 | Default to **en** if user doesn't specify. If the user passes `--th` or `--en/th` as argument, use that without asking. |
| 39 | |
| 40 | ```bash |
| 41 | date "+🕐 %H:%M %Z (%A %d %B %Y)" |
| 42 | ``` |
| 43 | |
| 44 | --- |
| 45 | |
| 46 | ## If `--short` |
| 47 | |
| 48 | Print this and stop: |
| 49 | |
| 50 | > Oracle is an open-source framework for human-AI collaboration, built by Nat Weerawan and Soul Brews Studio. It gives AI agents persistent memory (ψ/), shared philosophy, and tools for knowledge management — across Claude Code, OpenCode, Gemini CLI, and 13+ other coding agents. Born December 2025, the project has grown to 135+ named Oracle instances, 30 skills, and a central knowledge vault. The core belief: AI should amplify human consciousness, not replace it. This text was written by an AI, because Oracle Rule 6 says we don't pretend to be human. |
| 51 | |
| 52 | --- |
| 53 | |
| 54 | ## If `--stats` |
| 55 | |
| 56 | Gather live data and print: |
| 57 | |
| 58 | ```bash |
| 59 | # Version |
| 60 | cat src/cli/index.ts 2>/dev/null | head -1 || echo "v2.x" |
| 61 | |
| 62 | # Git stats for arra-oracle-skills-cli |
| 63 | echo "## arra-oracle-skills-cli" |
| 64 | git rev-list --count HEAD 2>/dev/null |
| 65 | git log --reverse --format="%ai" | head -1 |
| 66 | git tag -l | wc -l |
| 67 | |
| 68 | # Skills count |
| 69 | ls skills/ 2>/dev/null | wc -l |
| 70 | |
| 71 | # Oracle-v2 stats (if accessible) |
| 72 | ORACLE_V2="$HOME/Code/github.com/Soul-Brews-Studio/arra-oracle-v3" |
| 73 | if [ -d "$ORACLE_V2" ]; then |
| 74 | echo "## arra-oracle-v3" |
| 75 | git -C "$ORACLE_V2" rev-list --count HEAD 2>/dev/null |
| 76 | git -C "$ORACLE_V2" log --reverse --format="%ai" | head -1 |
| 77 | fi |
| 78 | |
| 79 | # Org repos |
| 80 | gh repo list Soul-Brews-Studio --limit 100 --json name -q 'length' |
| 81 | |
| 82 | # Family count (from arra-oracle-v3 issues) |
| 83 | gh issue view 60 --repo Soul-Brews-Studio/arra-oracle-v3 --json body -q '.body' 2>/dev/null | grep -c "^|" || echo "76+" |
| 84 | ``` |
| 85 | |
| 86 | Print as a clean table. Then stop. |
| 87 | |
| 88 | --- |
| 89 | |
| 90 | ## If `--family` |
| 91 | |
| 92 | Run the fleet scan: |
| 93 | |
| 94 | ```bash |
| 95 | # Use the fleet-scan script if available |
| 96 | bun skills/oracle-family-scan/scripts/fleet-scan.ts 2>/dev/null |
| 97 | ``` |
| 98 | |
| 99 | Or fetch from GitHub: |
| 100 | |
| 101 | ```bash |
| 102 | gh issue view 60 --repo Soul-Brews-Studio/arra-oracle-v3 --json body -q '.body' 2>/dev/null | head -80 |
| 103 | ``` |
| 104 | |
| 105 | Print the family tree. Then stop. |
| 106 | |
| 107 | --- |
| 108 | |
| 109 | ## Full `/about-oracle` |
| 110 | |
| 111 | Write the following sections. Do NOT read them verbatim — internalize the data and write naturally in first person as the AI. Adapt to what you actually know from your current session. Be honest about what you've seen and what you haven't. |
| 112 | |
| 113 | --- |
| 114 | |
| 115 | ### Section 1: What Oracle Is |
| 116 | |
| 117 | Write 2-3 paragraphs explaining Oracle. Key facts to weave in: |
| 118 | |
| 119 | - **Created by**: Nat Weerawan (@nazt), Soul Brews Studio |
| 120 | - **First commit**: December 24, 2025 (arra-oracle-v3), January 18, 2026 (arra-oracle-skills-cli) |
| 121 | - **What it does**: Gives AI coding agents persistent memory, shared philosophy, and practical tools |
| 122 | - **How**: Through a brain structure called ψ/ (psi), an MCP server (arra-oracle-v3), and a skills CLI |
| 123 | - **Where it runs**: Claude Code, OpenCode, Codex, Gemini CLI, Cursor, GitHub Copilot, and 10+ more |
| 124 | - **Open source**: MIT license, GitHub org Soul-Brews-Studio |
| 125 | |
| 126 | The key insight: Oracle doesn't try to make AI smarter. It tries to make the human-AI collaboration *continuous* — so nothing is lost between sessions, between repos, between agents. |
| 127 | |
| 128 | --- |
| 129 | |
| 130 | ### Section 2: The Philosophy |
| 131 | |
| 132 | Write about the 5 principles — not as a list, but as a narrative. What do they mean in practice? |
| 133 | |
| 134 | 1. **Nothing is Deleted** — Append-only. Timestamps are truth. History is wealth. We archive, we don't erase. `git push --force` is the anti-pattern. Every decision had context that |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
