Agent Oracle
SkillFiles & storageConsult a read-only expert advisor for one specific unresolved, high-impact judgment call — choosing between plausible designs with an unresolved tradeoff, checking a suspected invariant violation or failure sequence you could not settle, or a difficult cross-file bug that survived direct investigation. Do your own review, planning, and debugging first; the oracle is not for routine self-review, reassurance, "did I miss anything" sweeps, codebase searches, or executing changes.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Agent Oracle skill
What this skill tells your AI
The instructions your AI receives, as published by vaayne/agent-kit in skills/agent-oracle/SKILL.md and read by ahel’s review.
Spawn a read-only advisor subagent for exactly one unresolved decision, invariant, or debugging question. This is the most expensive role: consult it only when the answer would materially change a high-impact decision, and never spawn it merely to verify finished work.
When not to use
- Routine self-review, general reassurance, or a second pair of eyes.
- Broad "find anything I missed" requests — identify a concrete concern first.
- Work that is merely complex or high-impact without an unresolved question.
- Searches (agent-finder / agent-librarian) or making code changes (do it yourself or delegate implementation).
How to write the task
- State the unresolved question, what you already checked, and why the answer changes the decision.
- Constrain it to one decision, invariant, or debugging question; tell the oracle what to ignore so scope creep doesn't dilute the answer.
- Include the necessary context directly: relevant file paths inline, the intended behavior, and the constraints or product choices already settled.
- If asking about current changes, say so explicitly so it inspects
git diff. - State the output you need: the invariant and failing sequence if one exists, or a recommended alternative plus the evidence that would reverse the decision.
- For a follow-up review, name the prior finding and the exact change that should resolve it.
Signals
- GitHub stars
- 53
- Forks
- 4
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
agent-oracle- Source
- github.com/vaayne/agent-kit