CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

oracle

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.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary CLI skill body: nearly every line is an executable command, default, or constraint, with a golden path that includes dry-run validation and detach/reattach recovery. The only deductions are version-pinned model names scattered outside a deprecated section and a single-file layout that could offload some secondary detail to reference files.

DimensionReasoningScore

Conciseness

The body is dense and imperative with essentially no explanation of concepts Claude already knows — every section is commands, defaults, or constraints. It is penalized one notch because time-sensitive version information ("GPT‑5.2 Pro", "gpt-5.2-pro") appears throughout rather than in a deprecated/old-patterns section, and a few sections (remote browser host, exhaustive prompt pattern) run slightly long; anchor 4 rather than 5.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: complete commands like `npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"`, `oracle status --hours 72`, and exact mkdir/redirect recipes for the manual fallback. Defaults, excludes, and hidden flags are all specified concretely, matching anchor 5.

5 / 5

Workflow Clarity

The "Golden path" gives a clear numbered sequence with an explicit pre-send validation step ("Preview what you're about to send (`--dry-run` + `--files-report`)"), token-budget checkpoints, and an error-recovery loop for the main failure mode ("If the run detaches/timeouts: reattach to the stored session (don't re-run)" with the reattach commands). This matches anchor 5's sequence + checkpoints + feedback loop.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the single SKILL.md is well-organized with clear section headers covering one coherent topic, so there are no buried or nested references. It falls just short of anchor 5 because at ~115 lines, secondary material (remote browser host setup, the exhaustive-prompt pattern, session management details) could arguably live in one-level-deep reference files — minor organization gaps place it at 4.

4 / 5

Total

18

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, mechanism-specific, and written in third-person imperative voice with a clear what and an equivalent when clause. It is even across all dimensions, consistently landing at "good with minor gaps" — mainly missing trigger synonyms and the explicit "Use when..." form.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "bundle a prompt plus the right files", "get a second-model review (API or browser)" — with the named @steipete/oracle CLI domain. It lists multiple specific actions but coverage is not comprehensive (attachment selection, sessions, cost behavior are absent), matching anchor 4 rather than 5.

4 / 5

Completeness

The "what" is clear (bundles prompt + files into a second-model review via API or browser) and an equivalent "when" clause exists ("for debugging, refactors, design checks, or cross-validation"), so it avoids the missing-trigger cap of 3. It lacks the explicit "Use when..." phrasing and could be more specific, matching anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Natural trigger terms include "debugging, refactors, design checks, or cross-validation" plus "second-model review" — phrases a user would plausibly say. Common synonyms like "second opinion", "code review", or "another model" are missing, so it fits anchor 4 (good coverage, a few natural terms missing) rather than 5.

4 / 5

Distinctiveness Conflict Risk

The mechanism (bundling a prompt plus files for a second model via the @steipete/oracle CLI) carves out a distinct niche with minimal confusion risk. Terms like "debugging" and "design checks" mildly overlap with general code-review skills, placing it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

marchatton/agent-skills

Path

.agents/skills/00-utilities/oracle/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.