Agents Best Practices
DenisSergeevitch/agents-best-practices
A skill your agent uses when designing, generating an MVP blueprint for, auditing, troubleshooting, refactoring, or explaining an agentic harness for any domain.
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
Install Oracle
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sundial-org/awesome-openclaw-skills oracle --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/oracle .claude/skills/oracle && rm -rf skills-srcUse ~/.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/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .claude/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracleType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sundial-org/awesome-openclaw-skills oracle --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/oracle .agents/skills/oracle && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .agents/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sundial-org/awesome-openclaw-skills oracle --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/oracle .cursor/skills/oracle && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .cursor/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sundial-org/awesome-openclaw-skills.git --path skills/oracle--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sundial-org/awesome-openclaw-skills oracle --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/oracle .gemini/skills/oracle && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .gemini/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sundial-org/awesome-openclaw-skills oracleInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/oracle .github/skills/oracle && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .github/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sundial-org/awesome-openclaw-skills oracle --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sundial-org/awesome-openclaw-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/oracle .opencode/skills/oracle && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "oracle" agent skill from https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/oracle into .opencode/skills/oracle/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "oracle", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
oracle- GitHub stars
- 663
- Used in
- 2 other repos
- Token cost
- ~1.4k tokens
- SKILL.md length
- 727 words
- Files
- 1
- Skills in repo
- 383
- Repo updated
- First seen
- Licence
- None found
At a glance
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
- Works in 4 steps: Pick a tight file set (fewest files that… → Preview what you’re about to send… → Run in browser mode for the usual… → …
- Tasks that involve Refactoring
- SKILL.md covers Main use case (browser,…, Golden path (fast + reliable), 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 sundial-org/awesome-openclaw-skills. Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
Its SKILL.md is about 1.4k 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 Development, covering Refactoring, Machine learning and Prompt engineering. It works with OpenAI. The repository describes itself as: Top OpenClaw skills, with the most popular and useful ones.
When your agent uses it
- Tasks that involve Refactoring
- Tasks that involve Machine learning
- Tasks that involve Prompt engineering
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.
- Pick a tight file set (fewest files that still contain the truth).
- Preview what you’re about to send (--dry-run + --files-report when needed).
- Run in browser mode for the usual GPT‑5.2 Pro ChatGPT workflow; use API only when you explicitly want it.
- 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 b80cde2. 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.4k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 727 words of instructions outside code blocks.
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:110
- 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
Without a licence we can't republish the file, so here is its outline and opening line. It has 727 words (~1,432 tokens).
“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 outputs as advisory: verify against the codebase + tests.”
- name
- oracle
Files
Just SKILL.md in skills/oracle of sundial-org/awesome-openclaw-skills.
Open the folder on GitHubat commit b80cde2
Used in 2 other repositories
We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in sundial-org/awesome-openclaw-skills, which our catalogue first saw on October 9, 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Oracle this skillsundial-org/awesome-openclaw-skills | 663 | 2 repos | ~1.4k | Automated safety check: Notes | None | |
| Agents Best PracticesDenisSergeevitch/agents-best-practices | 2.4k | — | ~7.4k | Automated safety check: Pass | MIT | |
| Codexskills-directory/skill-codex | 1.5k | 3 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Goinference-gateway/inference-gateway | 214 | — | ~2.4k | Automated safety check: Pass | Apache-2.0 | |
| Deepchat SddThinkInAIXYZ/deepchat | 6.4k | — | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| Codexdavila7/claude-code-templates | 33k | 3 repos | ~1.3k | Automated safety check: Pass | MIT |
Similar skills
Codex
skills-directory/skill-codex
A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing
Go
inference-gateway/inference-gateway
Idiomatic Go - package and interface design, error wrapping, table-driven tests, generics, the modern standard library (slices/maps/cmp/errors.Join), current syntax, and logging discipline.
Deepchat Sdd
ThinkInAIXYZ/deepchat
Use before substantial DeepChat code, configuration, documentation, test, build, feature, issue, refactor, or architecture changes that need a durable RFC and an explicit execution path.
Codex
davila7/claude-code-templates
A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing.
Codex
poteto/noodle
Run Codex CLI (exec, resume) for parallel work, delegating tasks to another model, or background code generation.
More from sundial-org/awesome-openclaw-skills
All 383 skills in this repoUI UX Pro Max
sundial-org/awesome-openclaw-skills
UI/UX design intelligence and implementation guidance for building polished interfaces.
Web Deploy GitHub
sundial-org/awesome-openclaw-skills
Create and deploy single-page static websites to GitHub Pages with autonomous workflow.
Clawd Modifier
sundial-org/awesome-openclaw-skills
Modify Clawd, the Claude Code mascot. An agent skill from sundial-org/awesome-openclaw-skills.
Figma
sundial-org/awesome-openclaw-skills
Professional Figma design analysis and asset export. An agent skill from sundial-org/awesome-openclaw-skills.
Habit Flow
sundial-org/awesome-openclaw-skills
AI-powered atomic habit tracker with natural language logging, streak tracking, smart reminders, and coaching.
Edge Tts
sundial-org/awesome-openclaw-skills
Text-to-speech conversion using node-edge-tts npm package for generating audio from text.
Related
Works with
Categories
Questions about Oracle
What does Oracle do?
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation. Oracle is an agent skill from sundial-org/awesome-openclaw-skills. Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
When should I use Oracle?
Oracle fits situations like: tasks that involve Refactoring; tasks that involve Machine learning; tasks that involve Prompt engineering.
How do I install Oracle in Claude Code?
Run `npx skills add sundial-org/awesome-openclaw-skills --skill oracle -a claude-code`. Or copy the skill folder (skills/oracle in sundial-org/awesome-openclaw-skills) 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 sundial-org/awesome-openclaw-skills --skill oracle -a codex`. Or copy the skill folder (skills/oracle in sundial-org/awesome-openclaw-skills) 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 sundial-org/awesome-openclaw-skills --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?
No licence was found for Oracle or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Oracle use?
About 1.4k tokens (SKILL.md is roughly 5.7k 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: Agents Best Practices (DenisSergeevitch/agents-best-practices, 2.4k stars), Codex (skills-directory/skill-codex, 1.5k stars), Go (inference-gateway/inference-gateway, 214 stars) and Deepchat Sdd (ThinkInAIXYZ/deepchat, 6.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Oracle?
sundial-org (a GitHub organization) maintains it in sundial-org/awesome-openclaw-skills, which has 663 GitHub stars. The repository holds 383 skills in this directory. The repository was last updated on March 7, 2026.
Source: sundial-org/awesome-openclaw-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.