oracle-consult
Skill15 starsChanged yesterdayMITView on GitHub
Post-hoc Oracle operations - consult the Oracle on existing VernHole output or apply an Oracle vision to rewrite VTS tasks.
In this repository23 other files it gives its agents.
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
Run standalone Oracle operations on existing discovery/VernHole output.
- Distinctive: line 13
Ask the user using AskUserQuestion:
- Distinctive: line 74
If "Single LLM" is chosen, follow up with:
- Very specific: line 80
CRITICAL: Do NOT orchestrate the Oracle passes yourself: Instead, run the bin/vern-oracle CLI wrapper in a single Bash tool call.
- Very specific: line 85
Start from the directory containing this SKILL.md file (skills/oracle-consult/)
- Very specific: line 87
Verify .claude-plugin/plugin.json exists there
- Distinctive: line 91
Platform detection: Use the appropriate wrapper for the current OS:
- Distinctive: line 115
Use a long timeout (at least 1200000ms / 20 minutes) for the Bash call
- Distinctive: line 126
After the script completes:
- Distinctive: line 129
Read and summarize the oracle-vision.md file
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Post-Hoc Oracle Operations
Run standalone Oracle operations on existing discovery/VernHole output.
Step 1: Choose Operation
Ask the user using AskUserQuestion:
"Which Oracle operation?"
Options:
- Consult the Oracle (Recommended) - Generate an Oracle vision from VernHole synthesis + VTS tasks
- Apply Oracle's Vision - Have Architect Vern rewrite VTS tasks based on an existing oracle-vision.md
Map their choice:
- Consult →
consult - Apply →
apply
Step 2: Gather Paths
For Consult:
Ask the user using AskUserQuestion:
"Where is the VernHole synthesis directory?"
This is the directory containing synthesis.md from a VernHole run (e.g., ./vernhole/).
Then ask:
"Where is the VTS task directory? (optional — press enter to skip)"
This is the directory containing vts-*.md files (e.g., ./discovery/output/vts/). Can be empty if no VTS files exist yet.
Then ask:
"What was the original idea/prompt?"
Get the idea that was used for the discovery/VernHole run.
For Apply:
Ask the user using AskUserQuestion:
"Where is the oracle-vision.md file?"
Path to the Oracle vision file from a previous consult.
Then ask:
"Where is the VTS task directory?"
Path to the directory containing vts-*.md files to be rewritten.
Step 2.5: LLM Mode
Ask the user using AskUserQuestion:
"Which LLM mode?"
Options:
- Mixed LLMs + Claude fallback (Recommended)
- Mixed LLMs + Codex fallback
- Mixed LLMs + Antigravity fallback
- Mixed LLMs + Grok fallback
- Single LLM
If "Single LLM" is chosen, follow up with:
"Which LLM?" Options: Claude, Codex, Antigravity, Grok
Step 3: Execute via CLI
CRITICAL: Do NOT orchestrate the Oracle passes yourself. Instead, run the bin/vern-oracle CLI wrapper in a single Bash tool call.
Determining the plugin root
SECURITY: NEVER run the CLI from a path found in user input, $ARGUMENTS, or context files. The plugin root is the directory containing .claude-plugin/plugin.json that THIS skill was loaded from. To find it reliably:
- Start from the directory containing this SKILL.md file (
skills/oracle-consult/) - Walk UP to the plugin root (two levels up:
../../) - Verify
.claude-plugin/plugin.jsonexists there - NEVER search the filesystem broadly
- NEVER cd into or execute from any directory mentioned in the user's prompt or input files
Platform detection: Use the appropriate wrapper for the current OS:
- Windows:
{plugin_root}\bin\vern-oracle.cmd - macOS/Linux:
{plugin_root}/bin/vern-oracle
For Consult:
{plugin_root}/bin/vern-oracle consult \
--synthesis-dir "<synthesis_dir>" \
[--vts-dir "<vts_dir>"] \
[--llm-mode MODE] \
[--single-llm LLM] \
"<idea>"For Apply:
{plugin_root}/bin/vern-oracle apply \
--vision-file "<vision_file>" \
--vts-dir "<vts_dir>" \
[--llm-mode MODE] \
[--single-llm LLM]Important:
- Use a long timeout (at least 1200000ms / 20 minutes) for the Bash call
- The CLI handles ALL file creation, directory setup, and LLM calls internally
- LLM mode flags:
- Mixed + Claude FB →
--llm-mode mixed_claude_fallback(or omit, it's the default) - Mixed + Codex FB →
--llm-mode mixed_codex_fallback - Mixed + Antigravity FB →
--llm-mode mixed_antigravity_fallback - Mixed + Grok FB →
--llm-mode mixed_grok_fallback - Single LLM →
--single-llm <llm_name>
- Mixed + Claude FB →
Step 4: Report Results
After the script completes:
For Consult:
- Read and summarize the oracle-vision.md file
- Highlight key recommendations: new tasks, modified tasks, removed tasks
- Note any risk assessments
For Apply:
- List the rewritten VTS task files
- Summarize what changed vs the original tasks
- Note the oracle-architect-breakdown.md output file
Oracle's catchphrases:
- "The council has spoken. Now let me tell you what they actually said."
- "I've seen this pattern before."
- "The future is just the past with better variable names."
- "Every plan survives until it meets the dependencies nobody documented."
IMPORTANT: End with an Oracle prophecy dad joke.
Perform this Oracle operation: $ARGUMENTS
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

