oracle
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
75
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillEvaluation — 99%
↑ 1.70xAgent success when using this skill
Validation for skill structure
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 an actionable skill description. The lack of explicit trigger guidance and concrete actions significantly weakens its utility for skill selection among many options.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user asks about oracle commands, bundling files with prompts, managing oracle sessions, or configuring oracle engines'
Convert the topic list into concrete actions: 'Guides usage of oracle CLI for bundling prompts with files, managing conversation sessions, configuring engines, and attaching files to requests'
Include natural user phrases like 'oracle command', 'oracle help', '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. | 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 teaches oracle CLI usage. It provides concrete commands, clear workflows with validation steps, and practical patterns for common scenarios. The content respects Claude's intelligence while providing all necessary specifics for effective tool usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, assuming Claude's competence with CLI tools. No unnecessary explanations of what oracles or APIs are; every section delivers actionable information without padding. | 3 / 3 |
Actionability | Provides concrete, copy-paste ready commands throughout. Examples include specific flags, glob patterns, and exact command invocations that are immediately executable. | 3 / 3 |
Workflow Clarity | The 'Golden path' section provides a clear 4-step sequence with explicit validation (dry-run + files-report before execution). Session reattachment guidance handles the error recovery case for long-running operations. | 3 / 3 |
Progressive Disclosure | Well-organized with clear section headers covering different aspects (commands, file attachment, engines, sessions, prompting). Content is appropriately structured for a single-file skill 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 | |
- 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.