oracle

Bundles prompts and repository files into one-shot requests for external AI models.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill oracle-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oracle
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/oracle
Command: npx skills add https://github.com/srgaba/open-claw --skill oracle-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @steipete/oracle.

What problem does it solve? Getting a second opinion from another AI model on a codebase usually means manually copying files and context into a chat window. This Skill teaches how to use the oracle CLI to bundle a prompt plus selected files into a single one-shot request, so another model can answer with real repository context via API or browser automation. ## Core Features & Use Cases - Prompt + File Bundling: Attach files, directories, and globs with --file, including exclusion patterns, .gitignore awareness, and size limits. - Engine Selection: Use browser mode for GPT-5.2 Pro long-running sessions, or API mode for Claude, Grok, Codex, and multi-model runs. - Session Management: Reattach to detached or long-running stored sessions instead of re-running, with readable slugs and status listing. - Use Case: You hit a stubborn bug in your TypeScript service. You dry-run the payload to check token cost, then launch a browser run with GPT-5.2 Pro attaching src/** minus tests, and reattach to the session an hour later to read the advisory analysis. ## Quick Start Ask the AI to run oracle with a dry-run summary of your task prompt and the relevant source files to preview the payload and token cost before launching a full browser run.

Frequently Asked Questions about oracle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I attach files to an oracle CLI prompt?

Use the --file flag with files, directories, or glob patterns, repeating it as needed. Exclusions use a leading bang, like --file "src/**" --file "!**/*.test.*". Globs honor .gitignore, skip node_modules and similar dirs, and reject files over 1 MB.

How do I preview token cost before running oracle?

Run oracle with --dry-run summary plus --files-report to see the payload and token spend without sending anything. Use --dry-run full to inspect the complete rendered request before committing to a run.

Should I use oracle browser engine or API engine?

Use --engine browser for the GPT-5.2 Pro ChatGPT workflow, which is the default long-think path. Use --engine api for Claude, Grok, Codex, or multi-model runs; oracle auto-picks api when OPENAI_API_KEY is set.

What do I do when an oracle browser run times out?

Do not re-run; reattach to the stored session instead. List recent sessions with oracle status --hours 72, then run oracle session <id> --render to retrieve the output. Sessions live under ~/.oracle/sessions.

Can oracle runs leak secrets from my repository?

They can if you attach sensitive files, since everything matched by --file is sent to the model. Avoid attaching .env files, key files, and auth tokens, and redact aggressively before running.