Agent skill · software engineering · sundial-org
oracle
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
Why this skill is useful
Adds specific commands and workflows for using the @steipete/oracle CLI that enhance debugging and validation processes with AI models.
What it needs
Requires @steipete/oracle installed locally. Requires openai account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Oracle (CLI) — best use Oracle bundles your prompt + selected files into one “one-shot” request so another model can answer with real repo context (API or browser automation). Treat outputs as advisory: verify against the codebase + tests. Main use case (browser, GPT‑5.2 Pro) Default workflow here: --engine browser with GPT‑5.2 Pro in ChatGPT. This is the “human in the loop” path: it can take ~10 minutes to ~1 hour; expect a stored session you can reattach to. Recommended defaults: Engine: browser (--engine browser) Model: GPT‑5.2 Pro (either --model gpt-5.2-pro or a ChatGPT picker label like --model "5.2 Pro") Attachments: directories/globs + excludes; avoid secrets. Golden path (fast + reliable) 1. Pick a tight file set (fewest files that still contain the truth). 2. Preview what you’re about to send (--dry-run + --files-report when needed). 3. Run in browser mode for the usual GPT‑5.2 Pro ChatGPT workflow; use API only when you explicitly want it. 4. If the run detaches/timeouts: reattach to the stored session (don’t re-run). Commands (preferred) Show help (once/session): npx -y @steipete/oracle --help Preview (no tokens): npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/" --file "!/.test." npx -y @steipete/oracle --dry-run full -p "<task>" --file "src/" Token/cost sanity: npx -y @steipete/oracle --dry-run summary --files-report -p "<task>" --file "src/" Browser run (main path; long-running is normal): npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/" Manual paste fallback (assemble bundle, copy to clipboard): npx -y @steipete/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. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/oracle