oracle
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
78
Quality
70%
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
40%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, providing reasonable distinctiveness. However, it lacks concrete action verbs describing what the skill enables Claude to do, and critically missing explicit trigger guidance ('Use when...') which significantly limits Claude's ability to know when to select this skill.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about oracle CLI commands, bundling files with prompts, managing oracle sessions, or attaching files to oracle requests'
Replace 'Best practices for' with concrete actions like 'Configure oracle CLI sessions, bundle prompts with files, select engines, and attach files to requests'
Include natural user phrases like 'oracle command', 'oracle help', 'how to use oracle' as trigger terms
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (oracle CLI) and mentions specific concepts (prompt + file bundling, engines, sessions, file attachment patterns), but these are feature categories rather than concrete actions like 'create sessions' or 'bundle files'. | 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' which is a specific tool name users might mention, plus terms like 'sessions' and 'file attachment'. However, missing common variations users might say like 'oracle command', 'oracle tool', or action-oriented terms like 'how to use oracle'. | 2 / 3 |
Distinctiveness Conflict Risk | The 'oracle CLI' is a specific, named tool which creates a clear niche. Unlikely to conflict with other skills since it targets a particular CLI tool with distinct terminology. | 3 / 3 |
Total | 8 / 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 demonstrates best practices: it's concise, provides executable commands, has clear workflow guidance with validation steps, and is well-organized. The content respects Claude's intelligence while providing the specific, non-obvious details needed to use the oracle CLI effectively.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is lean and efficient throughout. No unnecessary explanations of what CLI tools are or how models work. 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, session management). Examples use real flags and realistic patterns. | 3 / 3 |
Workflow Clarity | Clear 'golden path' workflow with explicit steps. Includes validation checkpoint (dry-run + files-report before actual run) and recovery guidance (reattach to stored session instead of re-running). | 3 / 3 |
Progressive Disclosure | Well-organized sections that progress from main use case to commands to advanced topics (engines, sessions, prompts). Content is appropriately scoped for a single SKILL.md without needing external references. | 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
8763418
- 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.