New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Oracle

by trpc-group in trpc-group/trpc-agent-go

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

Apache-2.0Auto-check: notesDevOps & Cloud

Install Oracle

skills CLI
$ npx skills add trpc-group/trpc-agent-go --skill oracle -a claude-code

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

GitHub CLI
$ gh skill install trpc-group/trpc-agent-go 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/trpc-group/trpc-agent-go.git skills-src && mkdir -p .claude/skills && cp -r skills-src/openclaw/skills/oracle .claude/skills/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
oracle
GitHub stars
1.8k
Used in
10 other repos
Token cost
~1.3k tokens
SKILL.md length
577 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
Apache-2.0

At a glance

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

  • Works in 4 steps: Pick a tight file set (fewest files that… → Preview payload + token spend (--dry-run… → Use browser mode for the usual GPT‑5.2… → …
  • DevOps & Cloud work in your project
  • SKILL.md covers Main use case (browser,…, Golden path, Commands (preferred) and Attaching files (--file), plus 5 more sections
  • Calls npx; needs OPENAI_API_KEY

What it does

Oracle is an agent skill from trpc-group/trpc-agent-go. Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud. It works with OpenAI. The repository describes itself as: A Go framework for building production agent systems with graph workflows, tools, memory, A2A, AG-UI, MCP, evaluation, and observability. The licence is Apache-2.0.

When your agent uses it

  • DevOps & Cloud work in your project

Example prompts

  • “/oracle”

Requirements

  • Node.js
  • A credential in OPENAI_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Pick a tight file set (fewest files that still contain the truth).
  2. Preview payload + token spend (--dry-run + --files-report).
  3. Use browser mode for the usual GPT‑5.2 Pro workflow; use API only when you explicitly want it.
  4. If the run detaches/timeouts: reattach to the stored session (don’t re-run).

What it can do on your machine

Read from SKILL.md and the folder at commit 9bb1c42. 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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

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

Context cost

Oracle loads about 1.3k tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 577 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:115
    - Don’t attach secrets by default (`.env`, key files, auth tokens). Redact aggressively; share only what’s required.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from trpc-group/trpc-agent-go at commit 9bb1c42, republished under its Apache-2.0 licence (© trpc-group). 577 words, ~1,251 tokens.

Download SKILL.mdSave it as .claude/skills/oracle/SKILL.md (or your agent's skills folder).
name
oracle
description
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
homepage
https://askoracle.dev

oracle — best use

Oracle bundles your prompt + selected files into one “one-shot” request so another model can answer with real repo context (API or browser automation). Treat output as advisory: verify against code + tests.

Main use case (browser, GPT‑5.2 Pro)

Default workflow here: --engine browser with GPT‑5.2 Pro in ChatGPT. This is the common “long think” path: ~10 minutes to ~1 hour is normal; expect a stored session you can reattach to.

Recommended defaults:

  • Engine: browser (--engine browser)
  • Model: GPT‑5.2 Pro (--model gpt-5.2-pro or --model "5.2 Pro")

Golden path

  1. Pick a tight file set (fewest files that still contain the truth).
  2. Preview payload + token spend (--dry-run + --files-report).
  3. Use browser mode for the usual GPT‑5.2 Pro workflow; use API only when you explicitly want it.
  4. If the run detaches/timeouts: reattach to the stored session (don’t re-run).

Commands (preferred)

  • Help:

    • oracle --help
    • If the binary isn’t installed: npx -y @steipete/oracle --help (avoid pnpx here; sqlite bindings).

  • Preview (no tokens):

    • oracle --dry-run summary -p "<task>" --file "src/**" --file "!**/*.test.*"
    • oracle --dry-run full -p "<task>" --file "src/**"

  • Token sanity:

    • oracle --dry-run summary --files-report -p "<task>" --file "src/**"

  • Browser run (main path; long-running is normal):

    • oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"

  • Manual paste fallback:

    • oracle --render --copy -p "<task>" --file "src/**"
    • Note: --copy is a hidden alias for --copy-markdown.

Attaching files (--file)

--file accepts files, directories, and globs. You can pass it multiple times; entries can be comma-separated.

  • Include:

    • --file "src/**"
    • --file src/index.ts
    • --file docs --file README.md

  • Exclude:

    • --file "src/**" --file "!src/**/*.test.ts" --file "!**/*.snap"

  • Defaults (implementation behavior):

    • Default-ignored dirs: node_modules, dist, coverage, .git, .turbo, .next, build, tmp (skipped unless explicitly passed as literal dirs/files).
    • Honors .gitignore when expanding globs.
    • Does not follow symlinks.
    • Dotfiles filtered unless opted in via pattern (e.g. --file ".github/**").
    • Files > 1 MB rejected.

Engines (API vs browser)

  • Auto-pick: api when OPENAI_API_KEY is set; otherwise browser.
  • Browser supports GPT + Gemini only; use --engine api for Claude/Grok/Codex or multi-model runs.
  • Browser attachments:
    • --browser-attachments auto|never|always (auto pastes inline up to ~60k chars then uploads).
  • Remote browser host:
    • Host: oracle serve --host 0.0.0.0 --port 9473 --token <secret>
    • Client: oracle --engine browser --remote-host <host:port> --remote-token <secret> -p "<task>" --file "src/**"
Show full SKILL.md (216 more words)Show less

Sessions + slugs

  • Stored under ~/.oracle/sessions (override with ORACLE_HOME_DIR).
  • Runs may detach or take a long time (browser + GPT‑5.2 Pro often does). If the CLI times out: don’t re-run; reattach.
    • List: oracle status --hours 72
    • Attach: oracle session <id> --render
  • Use --slug "<3-5 words>" to keep session IDs readable.
  • Duplicate prompt guard exists; use --force only when you truly want a fresh run.

Prompt template (high signal)

Oracle starts with zero project knowledge. Assume the model cannot infer your stack, build tooling, conventions, or “obvious” paths. Include:

  • Project briefing (stack + build/test commands + platform constraints).
  • “Where things live” (key directories, entrypoints, config files, boundaries).
  • Exact question + what you tried + the error text (verbatim).
  • Constraints (“don’t change X”, “must keep public API”, etc).
  • Desired output (“return patch plan + tests”, “give 3 options with tradeoffs”).

Safety

  • Don’t attach secrets by default (.env, key files, auth tokens). Redact aggressively; share only what’s required.

“Exhaustive prompt” restoration pattern

For long investigations, write a standalone prompt + file set so you can rerun days later:

  • 6–30 sentence project briefing + the goal.
  • Repro steps + exact errors + what you tried.
  • Attach all context files needed (entrypoints, configs, key modules, docs).

Oracle runs are one-shot; the model doesn’t remember prior runs. “Restoring context” means re-running with the same prompt + --file … set (or reattaching a still-running stored session).

© trpc-group, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in openclaw/skills/oracle of trpc-group/trpc-agent-go.

Open the folder on GitHubat commit 9bb1c42

Used in 10 other repositories

We found 23 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 10 other GitHub owners. This page covers the copy in trpc-group/trpc-agent-go, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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.

Oracle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Oracle this skilltrpc-group/trpc-agent-go1.8k10 repos~1.3kAutomated safety check: NotesApache-2.0
Caveman Gateway SetupJuliusBrussee/caveman110k1 repos~2.6kAutomated safety check: WarnApache-2.0
Add Model Pricelitefuse/litefuse100—~3.6kAutomated safety check: PassCustom licence
Oraclesteipete/agent-scripts7.3k1 repos~2.1kAutomated safety check: NotesMIT
ML AIgrafana/skills279—~1.3kAutomated safety check: PassApache-2.0
GCP To AWSaws/agent-toolkit-for-aws2.8k—~15kAutomated safety check: PassApache-2.0

Similar skills

  • Caveman Gateway Setup

    JuliusBrussee/caveman

    Routes every LLM call in a repository through the Caveman Cloud gateway in record mode, so requests and costs are measured without changing behavior.

    110k GitHub starsUsed in 1 repo~2.6k tokens
    DevOps & CloudAuto-check: warnings

  • Add Model Price

    litefuse/litefuse

    Add new LLM model pricing entries to Litefuse's default-model-prices.json.

    100 GitHub stars~3.6k tokensUpdated 15 days ago
    DevOps & CloudAuto-check passed

  • Oracle

    steipete/agent-scripts

    Oracle second-model review: bundle prompts/files, debug, refactor, design.

    7.3k GitHub starsUsed in 1 repo~2.1k tokens
    DevOps & CloudAuto-check: notes

  • ML AI

    grafana/skills

    Official

    Turn on AI + ML features in Grafana Cloud — Grafana Assistant (NL → PromQL/LogQL/TraceQL, dashboard build, incident investigation, MCP integration), Dynamic Alerting (Prophet forecasting + DBSCAN…

    279 GitHub stars~1.3k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed

  • GCP To AWS

    aws/agent-toolkit-for-aws

    Official

    Migrate workloads from Google Cloud Platform to AWS — plus AI and agentic workloads from any provider.

    2.8k GitHub stars~15k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-check passed

More from trpc-group/trpc-agent-go

All 47 skills in this repo

  • Model Usage

    trpc-group/trpc-agent-go

    Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown.

    1.8k GitHub starsUsed in 19 repos~563 tokens
    Auto-check passed

  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 15 repos~656 tokens
    Auto-check passed

  • Tmux

    trpc-group/trpc-agent-go

    Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

    1.8k GitHub starsUsed in 24 repos~868 tokens
    Auto-check passed

  • Openai Image Gen

    trpc-group/trpc-agent-go

    Batch-generate images via OpenAI Images API. An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 13 repos~843 tokens
    Auto-check passed

  • GitHub

    trpc-group/trpc-agent-go

    GitHub operations via gh CLI: issues, PRs, CI runs, code review, API queries.

    1.8k GitHub starsUsed in 10 repos~1k tokens
    Auto-check passed

  • Weather

    trpc-group/trpc-agent-go

    Get current weather and forecasts via wttr.in or Open-Meteo.

    1.8k GitHub starsUsed in 9 repos~591 tokens
    Auto-check passed

Works with

Categories

Questions about Oracle

What does Oracle do?

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns). Oracle is an agent skill from trpc-group/trpc-agent-go. Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

When should I use Oracle?

Oracle fits situations like: devOps & Cloud work in your project.

How do I install Oracle in Claude Code?

Run `npx skills add trpc-group/trpc-agent-go --skill oracle -a claude-code`. Or copy the skill folder (openclaw/skills/oracle in trpc-group/trpc-agent-go) into .claude/skills/oracle in your project. Claude Code loads it when a task matches its description.

How do I install Oracle in Codex?

Run `npx skills add trpc-group/trpc-agent-go --skill oracle -a codex`. Or copy the skill folder (openclaw/skills/oracle in trpc-group/trpc-agent-go) into .agents/skills/oracle in your project. Codex loads it when a task matches its description.

Can I use 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 trpc-group/trpc-agent-go --skill 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/oracle, .gemini/skills/oracle, .github/skills/oracle and .opencode/skills/oracle in your project.

What does Oracle need to run?

Going by SKILL.md and its folder, Oracle needs the command-line tools its instructions call (npx) and credentials named OPENAI_API_KEY. Our summary lists: Node.js; A credential in OPENAI_API_KEY.

Does Oracle access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Oracle safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Oracle use?

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

How many tokens does Oracle use?

About 1.3k tokens (SKILL.md is roughly 5k 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 Oracle?

Skills that share tags, products or a category with Oracle: Caveman Gateway Setup (JuliusBrussee/caveman, 110k stars), Add Model Price (litefuse/litefuse, 100 stars), Oracle (steipete/agent-scripts, 7.3k stars) and ML AI (grafana/skills, 279 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oracle?

trpc-group (a GitHub organization) maintains it in trpc-group/trpc-agent-go, which has 1,848 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: trpc-group/trpc-agent-go on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.