Agent skill · software engineering · steipete
oracle
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
Why this skill is useful
Adds specific commands and usage patterns for the Oracle CLI that enhance AI's ability to interact with the tool effectively.
What it needs
Requires node installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
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 OPENAIAPIKEY 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/" Browser run (main path; long-running is normal): oracle --engine browser --model gpt-5.5-pro -p "<task>" --file "src/" Manual paste fallback: oracle --render --copy -p "<task>" --file "src/" Note: --copy is a hidden alias for --copy-markdown. Attaching files (--file) --file accepts files, directories, and globs. You can pass it multiple times; entries can be comma-separated. Include: --file "src/" --file src/index.ts --file docs --file README.md Exclude: --file "src/" --file "!src//.test.ts" --file "!/.snap" Defaults (implementation behavior): Default-ignored dirs: nodemodules, dist, coverage, .git, .turbo, .next, build, tmp (skipped unless explicitly passed as literal dirs/files). Honors .gitignore when expanding globs. Does not follow symlinks. Dotfiles filtered unless opted in via pattern (e.g. --file ".github/"). Files > 1 MB rejected. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/oracle--969782