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.
When & Why to Use This Skill
The Oracle CLI Claude skill is a powerful developer tool designed to streamline the process of cross-model code reviews and validation. By efficiently bundling specific source files and prompts into a single request, it allows developers to leverage secondary high-reasoning models (such as GPT-5.2 Pro, Gemini, or alternative Claude versions) for deep technical analysis, debugging, and architectural consistency checks. This skill optimizes the 'second-opinion' workflow, ensuring higher code quality through automated context-aware reviews.
Use Cases
- Cross-Model Validation: Verify complex logic or critical code paths by sending them to a different high-reasoning model to catch edge cases missed by the primary assistant.
- Context-Aware Debugging: Bundle relevant source files, dependencies, and error logs into a one-shot request to provide a secondary model with the full context needed to solve difficult bugs.
- Automated Code Refactoring: Package multiple related files for a comprehensive review to receive structural improvement suggestions and ensure refactoring consistency across the codebase.
- Design and Architecture Checks: Perform high-level design reviews by providing the model with a holistic view of project files to ensure adherence to specific design patterns or style guides.
| name | oracle |
|---|---|
| description | 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. |
Oracle CLI
Bundle prompt + files into a one-shot request to another model (GPT-5.2 Pro, Claude, Gemini) for review. Treat outputs as advisory.
Quick Start
# Preview (no tokens)
npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/**"
# Browser run (main path)
npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"
# Copy to clipboard for manual paste
npx -y @steipete/oracle --render --copy -p "<task>" --file "src/**"
Golden Path
- Pick tight file set (fewest files with the truth)
- Preview first (
--dry-run+--files-report) - Run browser mode for GPT-5.2 Pro; API for Claude/Grok
- If timeout: reattach to session, don't re-run
File Selection
--file "src/**" # Include glob
--file "!src/**/*.test.ts" # Exclude pattern
--file src/index.ts --file docs/ # Multiple files/dirs
Default ignores: node_modules, dist, .git, build, etc.
For detailed usage, engines, sessions, and prompt templates, see reference.md.