oracle
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
75
Quality
66%
Does it follow best practices?
Impact
99%
1.70xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/oracle/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a specific tool (oracle CLI) and lists relevant feature areas, but reads more like a topic list than actionable guidance. It lacks explicit trigger conditions and concrete actions Claude can perform, making it difficult for Claude to know when to select this skill from a large pool.
Suggestions
Add a 'Use when...' clause specifying triggers like 'when the user asks about oracle commands, oracle prompts, or bundling files with oracle'
Convert feature topics into concrete actions (e.g., 'Guides users on bundling files with prompts, managing oracle sessions, selecting engines, and attaching files')
Include natural user phrases like 'oracle help', 'oracle command', 'how to use oracle' to improve trigger term coverage
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (oracle CLI) and mentions several features (prompt + file bundling, engines, sessions, file attachment patterns), but these are listed as topics rather than concrete actions Claude can perform. | 2 / 3 |
Completeness | Describes what the skill covers (best practices for oracle CLI features) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'oracle CLI' and technical terms like 'sessions', 'engines', 'file bundling' which are relevant but may not match how users naturally ask for help. Missing common variations like 'oracle command', 'oracle tool', or action-oriented terms. | 2 / 3 |
Distinctiveness Conflict Risk | 'Oracle CLI' is fairly specific and unlikely to conflict with generic document or code skills, but 'best practices' is vague and could overlap with other CLI or tooling skills without clearer boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that efficiently documents the oracle CLI with concrete commands, clear workflows, and practical patterns. It respects token budget while providing comprehensive coverage of the tool's capabilities. The golden path workflow and session management guidance are particularly well-structured with appropriate validation checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is lean and efficient throughout. No unnecessary explanations of what CLI tools are or how they work—assumes Claude's competence. Every section delivers actionable information without padding. | 3 / 3 |
Actionability | Provides concrete, copy-paste ready commands for every operation (dry-run, browser run, file attachment patterns, session management). Examples are specific and executable with real flags and patterns. | 3 / 3 |
Workflow Clarity | Clear 'golden path' workflow with explicit steps. Includes validation checkpoint (dry-run + files-report before actual run) and explicit guidance on session reattachment for long-running operations instead of re-running. | 3 / 3 |
Progressive Disclosure | Well-organized sections with clear headers. Content is appropriately structured for a single-file skill—sections are logically ordered from main use case through commands, file attachment, engines, sessions, and advanced patterns. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- trpc-group/trpc-agent-go
- Commit
50ef2f3
- 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.