oracle
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
npx skills add Health-Yang/MineEcho --skill oracle --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# oracle Oracle bundles a prompt + selected files for one second-model pass. Treat output as advisory; verify against code + tests. ## Main path Current CLI default model: `gpt-5.5-pro`. Browser engine is useful for long ChatGPT Pro runs; API engine is useful when `OPENAI_API_KEY` or Azure config is ready. Recommended defaults: - Preview first: `--dry-run summary --files-report` - Browser long run: `--engine browser --model gpt-5.5-pro` - API explicit: `--engine api --model gpt-5.5` ## Golden path 1. Pick a tight file set (fewest files that still contain the truth). 2. Preview payload + token spend (`--dry-run` + `--files-report`). 3. Use browser mode for long Pro thinking; API mode for explicit API calls. 4. If the run detaches/timeouts: reattach to the stored session. Do not blindly re-run. ## Commands (preferred) - Help: - `oracle --help` - If the binary isn't installed: `npx -y @steipete/oracle --help` (avoid `pnpx` here; sqlite bindings). - Preview (no tokens): - `oracle --dry-run summary -p "<task>" --file "src/**" --file "!**/*.test.*"` - `oracle --dry-run full -p "<task>" --file "src/**"` - Token sanity: - `oracle --dry-run summary --files-report -p "<task>" --file "src/**"
- Main path
- Golden path
- Commands (preferred)
- Attaching files (--file)
- Engines (API vs browser)
- Sessions + slugs
- Prompt template (high signal)
- Safety
- "Exhaustive prompt" restoration pattern
What does the oracle skill do?
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
How do I install it?
Run `npx skills add Health-Yang/MineEcho --skill oracle --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Health-Yang/MineEcho, a repository with 248 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
