← Back to Skills Marketplace
utromaya-code

Oracle

by utromaya-code · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
100
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install prompt-bundler-oracle
Description
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
Usage Guidance
This skill is largely documentation for the oracle CLI and installs via an npm package. Before installing or running it: 1) Verify the npm package owner (@steipete) and inspect the package contents or source repo if you don't already trust it. 2) Be aware SKILL.md references OPENAI_API_KEY and ORACLE_HOME_DIR even though they aren't declared — if you have these env vars set, the CLI may use them; ensure any API keys you have are appropriate for the intended runs. 3) Never attach secret files; the docs repeat this but the tool can upload attachments in browser mode — only include the minimal files needed and scrub secrets. 4) Avoid running the serve command bound to 0.0.0.0 on an Internet-exposed host; if you must accept remote connections, bind to loopback or place behind a firewall and use strong tokens. 5) Consider installing the CLI in an isolated environment (container or dedicated VM) if you will run it against sensitive repositories. If you want more assurance, provide the package source (repo or npm link) so it can be reviewed for unexpected behavior.
Capability Analysis
Type: OpenClaw Skill Name: prompt-bundler-oracle Version: 1.0.0 The skill describes a CLI tool ('oracle') for bundling local files and sending them to external LLM providers via API or browser automation. It possesses high-risk capabilities, including broad file system access (via globs), network communication, and a remote server mode ('oracle serve' on port 9473). While these features are consistent with the stated purpose of providing repository context to AI models, the inherent risk of data exfiltration and the reference to a non-existent 'GPT-5.2 Pro' model are concerning. The skill instructs the agent to install and execute an external Node package (@steipete/oracle) and manage sessions in '~/.oracle/sessions' (SKILL.md).
Capability Assessment
Purpose & Capability
Name/description describe best practices for the oracle CLI and the manifest requires the 'oracle' binary (or installs @steipete/oracle from npm). Requiring a CLI binary (or installing it via a node package) is proportional to the stated purpose.
Instruction Scope
SKILL.md provides runtime instructions that stay on-topic (how to pick files, engines, sessions, attachments). It references behavior that can upload pasted/attached files (browser attachments, remote host upload) and tells users not to attach secrets. It also references environment variables and session paths (OPENAI_API_KEY, ORACLE_HOME_DIR, ~/.oracle/sessions) and a remote serve command that binds to 0.0.0.0. These are expected for this CLI but are operationally significant (potential data upload, exposed service) and should be reviewed by the user.
Install Mechanism
Install is via an npm package (@steipete/oracle) which will create the 'oracle' binary. npm installs are a common and expected mechanism for a JS/Node CLI; they carry the usual moderate registry risk (package-owner trust, supply-chain considerations). There are no direct downloads from arbitrary URLs or extract operations listed.
Credentials
The manifest declares no required env vars, but SKILL.md references OPENAI_API_KEY (to auto-pick API engine) and an override ORACLE_HOME_DIR. Those env vars are not declared in the skill metadata. While the referenced variables are plausible for the tool, the mismatch between declared requirements and instructions means the agent may rely on user-provided credentials or paths that the metadata doesn't advertise — review your environment before running.
Persistence & Privilege
The skill does not request always:true and is user-invocable only. The instructions note session storage under ~/.oracle/sessions, which is limited to the tool's own directory and is reasonable for a CLI that stores sessions. The skill does show how to run a remote server (oracle serve --host 0.0.0.0 --port 9473 --token <secret>) — running that exposes a network service and should be done intentionally and with proper network controls.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install prompt-bundler-oracle
  3. After installation, invoke the skill by name or use /prompt-bundler-oracle
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the oracle skill, providing best practices for using the oracle CLI. - Covers prompt and file bundling, engine choices (browser/API), sessions, and file attachment patterns. - Includes recommended defaults for browser-based GPT‑5.2 Pro workflows and session management. - Details commands for preview, token checks, and browser or manual workflows. - Documents file inclusion/exclusion patterns, engine behaviors, session handling, and prompt templates. - Emphasizes safety guidance and thorough context restoration for reproducible runs.
Metadata
Slug prompt-bundler-oracle
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Oracle?

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns). It is an AI Agent Skill for Claude Code / OpenClaw, with 100 downloads so far.

How do I install Oracle?

Run "/install prompt-bundler-oracle" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Oracle free?

Yes, Oracle is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Oracle support?

Oracle is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Oracle?

It is built and maintained by utromaya-code (@utromaya-code); the current version is v1.0.0.

💬 Comments