oracle

oracle 🔮

A fortune-cookie-style Claude Code skill. Ask the oracle and it draws a random, playful, encouraging answer of the day from a pre-written pool — bilingual (Chinese / English), auto-detected, and independent of whatever you ask.

oracle = an oracle 🔮, and a pun on the Oracle database.

Installation

Install it from the Claude Code plugin marketplace — no file copying, no dependencies.

In Claude Code, add this repo as a marketplace, then install the plugin:

/plugin marketplace add d-bytebase/oracle
/plugin install oracle@oracle

The plugin bundles everything it needs (SKILL.md + the two answer banks). shuf is used if present and falls back to awk automatically, so macOS works out of the box. Use the /plugin menu to browse, update, or remove installed plugins.

Usage

Plugin skills are namespaced plugin:skill, so the command is /oracle:oracle:

/oracle:oracle                 # answer in the conversation's language
/oracle:oracle zh              # force Chinese
/oracle:oracle en              # force English
/oracle:oracle should I ship?  # ask a question (ritual only — the answer is unrelated)

You can also just ask the oracle in plain language — Claude triggers the skill from its description.

How it works

• Answers are pre-written (500 zh + 500 en) and drawn with shuf (or an awk fallback) — truly random. Claude never "picks" the line, so there's no bias or favourites.
• Language detection only chooses which bank; the draw itself is always random.
• The question is ritual only — the answer has nothing to do with it.

See the design spec.