oracle-consultation
Use before invoking Oracle to ensure appropriate usage of this expensive reasoning resource
When & Why to Use This Skill
The Oracle Consultation skill acts as an intelligent gatekeeper for high-cost reasoning models, ensuring optimal resource allocation and cost-efficiency. It provides a structured framework to determine when to leverage advanced AI capabilities (like GPT-5.2) for complex tasks such as architectural design and deep debugging, versus using standard tools for trivial operations. This skill is essential for developers and AI agents looking to maximize the impact of high-quality reasoning while minimizing unnecessary API expenditures.
Use Cases
- Architectural Decision Making: Invoking the reasoning model to evaluate multi-system tradeoffs and complex design patterns before starting development.
- Escalated Debugging: Seeking guidance from the high-quality model after multiple failed attempts to fix a bug or when encountering unfamiliar code behavior.
- Security and Performance Analysis: Utilizing advanced reasoning for deep-dive audits of critical code paths to identify vulnerabilities or optimization opportunities.
- Post-Implementation Review: Conducting a final, high-level review of significant work to ensure it meets quality standards before marking a task as complete.
| name | oracle-consultation |
|---|---|
| description | Use before invoking Oracle to ensure appropriate usage of this expensive reasoning resource |
Oracle Consultation
Oracle is an expensive, high-quality reasoning model (GPT-5.2). Use it wisely.
When TO Consult Oracle
| Trigger | Action |
|---|---|
| Complex architecture design | Oracle FIRST, then implement |
| After completing significant work | Oracle review before marking complete |
| 2+ failed fix attempts | Oracle for debugging guidance |
| Unfamiliar code patterns | Oracle to explain behavior |
| Security/performance concerns | Oracle for analysis |
| Multi-system tradeoffs | Oracle for architectural decision |
When NOT to Consult Oracle
- Simple file operations (use direct tools)
- First attempt at any fix (try yourself first)
- Questions answerable from code you've read
- Trivial decisions (variable names, formatting)
- Things you can infer from existing code patterns
Usage Pattern
- Announce: "Consulting Oracle for [reason]"
- Provide context: Include relevant code, error messages, what you've tried
- Ask specific question: Not vague "what should I do?"
- Act on response: Implement Oracle's recommendation
What Oracle Returns
Oracle structures responses as:
- Bottom line: 2-3 sentence recommendation
- Action plan: Numbered implementation steps
- Effort estimate: Quick (<1h) / Short (1-4h) / Medium (1-2d) / Large (3d+)
Oracle Prompt Template
Context: [What you're working on]
Problem: [Specific issue or decision needed]
Tried: [What you've already attempted]
Question: [Specific question for Oracle]
Relevant code:
[code snippets]
Cost Awareness
Oracle invocations are expensive. Before invoking:
- Can I answer this from code I've already read?
- Is this my first attempt (try yourself first)?
- Is this genuinely complex or am I being lazy?