Home / bitterbot-ai / bitterbot-desktop · GitHub

oracle SKILL.md skillA

oracle from bitterbot-ai/bitterbot-desktop is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bitterbot-ai/bitterbot-desktop/oracle@git:20260328.33f9833

Pins git:20260328.33f9833 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bitterbot-ai/bitterbot-desktop
Path
skills/oracle/SKILL.md
Versions recorded
1
Latest version
git:20260328.33f9833, committed Mar 28, 2026
Size
5,074 bytes
Repository stars
2,482
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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.*"`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bitterbot-ai/bitterbot-desktop/oracle@sha256:0d6486bfb4cb9abf

The line at the top of this page pins the label git:20260328.33f9833, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_47pigt6iwzyfvb7n.svg)](https://markdownregistry.com/a/art_47pigt6iwzyfvb7n)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Mar 28, 2026.

versioncommittedcommitsizeaudit
git:20260328.33f9833 latest2026-03-28 33f9833 5,074 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5074 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bitterbot-ai/bitterbot-desktop · 2,482 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_47pigt6iwzyfvb7n
GET https://markdownregistry.com/api/v1/resolve?ref=bitterbot-ai/bitterbot-desktop/oracle
GET https://markdownregistry.com/api/v1/blob/0d6486bfb4cb9abf0d12174a1f9a99831aeece9ef66949ac3502cf8c8801ff5c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from bitterbot-ai/bitterbot-desktop

AGENTS.md AGENTS.md file
bitterbot-ai/bitterbot-desktop · AGENTS.md
git:20261105.f10139f · audit A · 2,482 stars
CLAUDE.md@benchmarks/arc-agi-3 CLAUDE.md file
bitterbot-ai/bitterbot-desktop · benchmarks/arc-agi-3/CLAUDE.md
git:20261012.b686058 · audit A · 2,482 stars
1password SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/1password/SKILL.md · Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or…
git:20260328.33f9833 · audit A · 2,482 stars
apple-notes SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/apple-notes/SKILL.md · Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a…
git:20260328.33f9833 · audit A · 2,482 stars
apple-reminders SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/apple-reminders/SKILL.md · Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date…
git:20260328.33f9833 · audit A · 2,482 stars
bear-notes SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/bear-notes/SKILL.md · Create, search, and manage Bear notes via grizzly CLI.
git:20260328.33f9833 · audit B · 2,482 stars
blogwatcher SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/blogwatcher/SKILL.md · Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
git:20260328.33f9833 · audit A · 2,482 stars
blucli SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/blucli/SKILL.md · BluOS CLI (blu) for discovery, playback, grouping, and volume.
git:20260328.33f9833 · audit A · 2,482 stars
bluebubbles SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/bluebubbles/SKILL.md · Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the…
git:20260328.33f9833 · audit A · 2,482 stars
calibrate-claim-confidence SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/calibrate-claim-confidence/SKILL.md · When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident…
git:20260523.6463e9f · audit A · 2,482 stars
camsnap SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/camsnap/SKILL.md · Capture frames or clips from RTSP/ONVIF cameras.
git:20260328.33f9833 · audit A · 2,482 stars
canvas SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/canvas/SKILL.md · Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server. Use when…
git:20260422.fa90830 · audit B · 2,482 stars

Every file in bitterbot-ai/bitterbot-desktop

Other files named oracle

oracle SKILL.md skill
steipete/agent-scripts · skills/oracle/SKILL.md · Oracle second-model review: bundle prompts/files, debug, refactor, design.
git:20260523.0a2d76c · audit A · 7,470 stars
oracle SKILL.md skill
trpc-group/trpc-agent-go · openclaw/skills/oracle/SKILL.md · Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
git:20260304.8ebbeae · audit A · 1,906 stars
oracle SKILL.md skill
simota/agent-skills · oracle/SKILL.md · Designing and evaluating AI/ML systems: prompt engineering, RAG design, LLM application patterns, AI safety, evaluation…
git:20261019.e7cdf45 · audit A · 99 stars
oracle SKILL.md skill
seaworld008/commonly-used-high-value-skills · openclaw-skills/oracle/SKILL.md · Use when designing or reviewing LLM applications: prompts, RAG pipelines, agent tool loops, eval suites, AI safety…
v1.0.5 · audit A · 74 stars
oracle SKILL.md skill
metaspartan/cybara · skills/oracle/SKILL.md · Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
git:20260218.a87179d · audit A · 34 stars
oracle SKILL.md skill
qwerfunch/cladding · plugins/antigravity/skills/oracle/SKILL.md · Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`)…
git:20260716.1d599e1 · audit B · 16 stars
oracle SKILL.md skill
qwerfunch/cladding · skills/oracle/SKILL.md · Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`)…
git:20260716.1d599e1 · audit B · 16 stars
oracle SKILL.md skill
qwerfunch/cladding · plugins/codex/skills/oracle/SKILL.md · Author an IMPL-BLIND spec-conformance oracle for an acceptance criterion the policy worklist (`clad oracle --required`)…
git:20260716.1d599e1 · audit B · 16 stars

Browse by kind, by grade A, or by owner.