Agent skill

Consult Oracle

by tobihagemann in tobihagemann/turbo

Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches.

MITAuto-check passedProductivity & Automation

Install Consult Oracle

skills CLI
$ npx skills add tobihagemann/turbo --skill consult-oracle -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tobihagemann/turbo consult-oracle --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tobihagemann/turbo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/codex/skills/consult-oracle .claude/skills/consult-oracle && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
consult-oracle
GitHub stars
408
Token cost
~1.1k tokens
SKILL.md length
489 words
Files
2 (incl. scripts)
Skills in repo
81
Repo updated
First seen
Licence
MIT

At a glance

Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches.

  • Works in 5 steps: Identify Key Files → Formulate the Question → Run the Oracle → …
  • Stuck on a very hard problem
  • SKILL.md covers Configuration, Step 1: Identify Key Files, Step 2: Formulate the Question and Step 3: Run the Oracle, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches chatgpt.com

What it does

Consult Oracle is an agent skill from tobihagemann/turbo. Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches. Use when stuck on a very hard problem, when standard approaches have failed, when multiple debugging attempts haven't worked, or when the user says "ask the oracle", "consult oracle", "consult chatgpt", "I'm completely stuck", "I've tried everything", or "nothing is working".

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/run_oracle.py`).

It sits in Productivity & Automation, covering Browser automation. It works with OpenAI. The repository describes itself as: Reusable workflows for planning, building, reviewing, and shipping with Claude Code and Codex. The licence is MIT.

When your agent uses it

  • Stuck on a very hard problem
  • Standard approaches have failed
  • Multiple debugging attempts havent worked
  • The user says ask the oracle

Example prompts

  • “t worked, or when the user says”
  • “consult oracle”
  • “consult chatgpt”
  • “/consult-oracle”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Identify Key Files
  2. Formulate the Question
  3. Run the Oracle
  4. Follow Up
  5. Synthesize

What it can do on your machine

Read from SKILL.md and the folder at commit 931eda5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • chatgpt.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Consult Oracle loads about 1.1k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 489 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tobihagemann/turbo at commit 931eda5, republished under its MIT licence (© tobihagemann). 489 words, ~1,054 tokens.

Download SKILL.mdSave it as .claude/skills/consult-oracle/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
consult-oracle
description
Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches. Use when stuck on a very hard problem, when standard approaches have failed, when multiple debugging attempts haven't worked, or when the user says "ask the oracle", "consult oracle", "consult chatgpt", "I'm completely stuck", "I've tried everything", or "nothing is working".

Consult Oracle

Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches.

Configuration

The oracle reads from ~/.turbo/config.json:

json
{
  "oracle": {
    "chatgptUrl": "https://chatgpt.com/"
  }
}
KeyPurposeDefault
chatgptUrlChatGPT URL (e.g., a custom GPT project URL)https://chatgpt.com/

Step 1: Identify Key Files

Find the 2-5 files most relevant to the problem.

Step 2: Formulate the Question

Write a clear, specific problem description. Include what has already been tried and why it failed. Open with a short project briefing (stack, services, build steps). The more context, the better the response.

Step 3: Run the Oracle

Use a generous timeout (60 minutes / 3600000ms). The script loads chatgptUrl from ~/.turbo/config.json automatically and consults through the oracle's own signed-in ChatGPT profile. Generate a random tag and persist the response:

bash
ORACLE_TAG=$(head -c 4 /dev/urandom | xxd -p) && mkdir -p "$PWD/.turbo/oracle" && echo "$PWD/.turbo/oracle/$ORACLE_TAG.txt"

Substitute the printed value for <printed-path> in the command below and on every follow-up turn. Shell variables do not survive between shell calls, and an earlier cd in a compound command leaves the session in a different directory, so a relative path resolves against that directory instead.

bash
python3 scripts/run_oracle.py --prompt "<problem description>" --file <relevant files...> --write-output "<printed-path>"

Keep backticks, $, and straight double quotes out of --prompt even in text you wrote: the first two stay live inside the quotes, and a double quote ends them. Text you did not author — a diff, file contents, an error trace, command output — goes in a file passed with --file, written with apply_patch, as does any title or passage the prompt would otherwise quote. This holds on follow-up turns too.

If the run fails, retry the command once — same prompt, attachments, and timeout — when the failure looks transient, such as a browser challenge or automation error while the signed-in session is otherwise healthy. Report an authentication, browser-challenge, or permission blocker only after the retry reproduces it, and cite the failing output. Do not broaden permissions when the current context already has the access the run needs.

Show full SKILL.md (185 more words)Show less

Step 4: Follow Up

Resume the same ChatGPT conversation with --followup and the session slug. The prior turn's attached files and context persist, so re-attaching the full diff each turn is unnecessary. Use the same generous timeout as Step 3 (60 minutes / 3600000ms):

bash
python3 scripts/run_oracle.py --followup "<session-slug>" --prompt "<follow-up>" --write-output "<printed-path>"

Find the slug with python3 scripts/run_oracle.py status (the Slug column; follow-ups nest under their parent session) or from the directory names under ~/.oracle/sessions/.

Reuse the chat for a multi-turn review of the same code; start a fresh session (Step 3) for an unrelated question. Cap at 5 turns to prevent runaway conversations.

When the reviewed code changed since the prior turn, re-attach the changed files (--file <paths>) or a fresh diff, or state what changed. Otherwise the model reasons from the earlier attachments and flags already-fixed issues as live contradictions.

Step 5: Synthesize

Read the response from <printed-path>. Summarize the key insights from the consultation. Cross-reference suggestions with official docs and peer open-source implementations before applying. Oracle suggestions are starting points, not guaranteed solutions.

Then call update_plan to mark this step completed and continue with the next step of the active workflow.

© tobihagemann, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in codex/skills/consult-oracle of tobihagemann/turbo.

  • SKILL.md
  • scripts/run_oracle.py

Open the folder on GitHubat commit 931eda5

Compare with similar skills

Consult Oracle next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Consult Oracle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Consult Oracle this skilltobihagemann/turbo408—~1.1kAutomated safety check: PassMIT
Codex Bridge Chatgptanightmonarch/codex-bridge-chatgpt147—~1.1kAutomated safety check: PassMIT
Browser Intentruvnet/ruflo74k—~1.2kAutomated safety check: NotesMIT
BrowserWing AdminMemTensor/MemOS12k—~4.1kAutomated safety check: NotesApache-2.0
Scrapingbee CLIScrapingBee/scrapingbee-cli108—~3.2kAutomated safety check: NotesMIT
Page AgentTommy-yw/RunbookHermes5463 repos~2.3kAutomated safety check: NotesMIT

Similar skills

  • Codex Bridge Chatgpt

    anightmonarch/codex-bridge-chatgpt

    A skill your agent uses when a complex repository task needs ChatGPT web reasoning while Codex remains responsible for local evidence, edits, and tests.

    147 GitHub stars~1.1k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Browser Intent

    ruvnet/ruflo

    Execute a natural-language browser intent via page-agent (browseract) when the target is easier to describe than to select — degrades gracefully when page-agent or an OpenAI-compatible LLM provider…

    74k GitHub stars~1.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • BrowserWing Admin

    MemTensor/MemOS

    Installs, configures and operates BrowserWing, a browser automation platform, covering Chrome setup, LLM provider configuration, and creating or running automation scripts.

    12k GitHub stars~4.1k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check: notes
  • Scrapingbee CLI

    ScrapingBee/scrapingbee-cli

    Fetch and read any web page, search the web, crawl a site, or pull structured data out of pages.

    108 GitHub stars~3.2k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check: notes
  • Page Agent

    Tommy-yw/RunbookHermes

    Embed alibaba/page-agent into your own web application — a pure-JavaScript in-page GUI agent that ships as a single <script tag or npm package and lets end-users of your site drive the UI with…

    546 GitHub starsUsed in 3 repos~2.3k tokens
    Productivity & AutomationAuto-check: notes
  • Surf

    w-winter/dot314

    Control Chrome browser via CLI for testing, automation, and debugging.

    139 GitHub stars~7.6k tokensUpdated today
    Productivity & AutomationAuto-check: warnings

More from tobihagemann/turbo

All 81 skills in this repo
  • Fetch PR Comments

    tobihagemann/turbo

    Fetch and summarize review feedback and conversation from a GitHub PR (unresolved review threads, review bodies, and PR conversation comments) without making changes.

    408 GitHub stars~967 tokensUpdated 2 days ago
    Auto-check passed
  • Recall Rationale

    tobihagemann/turbo

    Recall why a past change was made by locating the Claude Code transcript that produced it.

    408 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Resolve PR Comments

    tobihagemann/turbo

    Evaluate, fix, answer, and reply to GitHub pull request review comments and conversation comments.

    408 GitHub stars~3.8k tokensUpdated 2 days ago
    Auto-check passed
  • Resolve PR Comments

    tobihagemann/turbo

    Evaluate, fix, answer, and reply to GitHub pull request review comments and conversation comments.

    408 GitHub stars~3.8k tokensUpdated 2 days ago
    Auto-check passed
  • Assess Technical Debt

    tobihagemann/turbo

    Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters, architecture rot, and low-value tests.

    408 GitHub stars~2.8k tokensUpdated 2 days ago
    Auto-check passed
  • Codex Exec

    tobihagemann/turbo

    Run autonomous task execution using the codex CLI. An agent skill from tobihagemann/turbo.

    408 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Consult Oracle

What does Consult Oracle do?

Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches. Consult Oracle is an agent skill from tobihagemann/turbo. Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches.

When should I use Consult Oracle?

Consult Oracle fits situations like: stuck on a very hard problem; standard approaches have failed; multiple debugging attempts havent worked; the user says ask the oracle.

How do I install Consult Oracle in Claude Code?

Run `npx skills add tobihagemann/turbo --skill consult-oracle -a claude-code`. Or copy the skill folder (codex/skills/consult-oracle in tobihagemann/turbo) into .claude/skills/consult-oracle in your project. Claude Code loads it when a task matches its description.

How do I install Consult Oracle in Codex?

Run `npx skills add tobihagemann/turbo --skill consult-oracle -a codex`. Or copy the skill folder (codex/skills/consult-oracle in tobihagemann/turbo) into .agents/skills/consult-oracle in your project. Codex loads it when a task matches its description.

Can I use Consult Oracle in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tobihagemann/turbo --skill consult-oracle -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/consult-oracle, .gemini/skills/consult-oracle, .github/skills/consult-oracle and .opencode/skills/consult-oracle in your project.

What does Consult Oracle need to run?

Going by SKILL.md and its folder, Consult Oracle needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Consult Oracle access the network?

SKILL.md names 1 domain. In commands or code: chatgpt.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Consult Oracle safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Consult Oracle use?

Consult Oracle is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Consult Oracle use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Consult Oracle?

Skills that share tags, products or a category with Consult Oracle: Codex Bridge Chatgpt (anightmonarch/codex-bridge-chatgpt, 147 stars), Browser Intent (ruvnet/ruflo, 74k stars), BrowserWing Admin (MemTensor/MemOS, 12k stars) and Scrapingbee CLI (ScrapingBee/scrapingbee-cli, 108 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Consult Oracle?

tobihagemann (a GitHub user) maintains it in tobihagemann/turbo, which has 408 GitHub stars. The repository holds 81 skills in this directory. The repository was last updated on October 9, 2026.

Source: tobihagemann/turbo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.