CtrlK
BlogDocsLog inGet started
Tessl Logo

omni-cache

Manage the LLM response cache. View cache statistics, clear entries, configure TTL policies, and control semantic-similarity caching thresholds.

60

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/omni-cache/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

The body is a compact, well-structured API reference with executable curl examples for every endpoint and a clear pointer to the full OpenAPI spec. Its main weakness is the destructive cache-clear operation lacking any validation or verification checkpoint, which caps workflow clarity.

Suggestions

Add a validation/verification step around the destructive DELETE operations, e.g. 'Before clearing, confirm with the user or run GET /api/cache/stats to record a baseline; after clearing, re-run GET /api/cache to verify counts reset to zero.'

Remove the Overview section or replace it with a one-line purpose statement to eliminate the verbatim duplication of the frontmatter description.

Include a brief example response for at least GET /api/cache/stats so Claude can interpret the stats fields without loading the OpenAPI spec.

DimensionReasoningScore

Conciseness

The body is lean with copy-paste curl commands and no padding of concepts Claude already knows; the only redundancy is the Overview repeating the frontmatter description verbatim, keeping it just below the 5-anchor.

4 / 5

Actionability

Each endpoint ships a concrete, executable curl example with the auth header, but no example responses or payload schemas are shown inline (deferred to the OpenAPI spec), leaving minor gaps versus the 5-anchor.

4 / 5

Workflow Clarity

Endpoints are listed clearly, but 'DELETE /api/cache — Clear all caches' is a destructive batch operation with no validation or verification checkpoint, and the rubric explicitly caps such skills at 3 even when single-purpose.

3 / 5

Progressive Disclosure

Content is well-organized into Overview, Authentication, Endpoints, and Payloads sections with a clearly signaled one-level reference to the OpenAPI spec for detailed schemas; minor gaps (the redundant Overview, an external rather than bundled spec reference) keep it at 4.

4 / 5

Total

15

/

20

Passed

Description

71%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.

The description is specific and actionable, enumerating four concrete cache-management capabilities, but it omits any 'when to use' trigger guidance, which caps completeness and slightly weakens distinctiveness. Trigger terms are solid but somewhat technical.

Suggestions

Add an explicit trigger clause, e.g. 'Use when managing the LLM response cache, adjusting cache TTL, or troubleshooting cache hit/miss behavior.'

Include more natural user-facing synonyms such as 'flush cache', 'cache hit rate', or 'cache invalidation' alongside the technical terms.

DimensionReasoningScore

Specificity

Lists four concrete actions — 'View cache statistics, clear entries, configure TTL policies, and control semantic-similarity caching thresholds' — giving comprehensive coverage of the cache-management domain, matching the 5-anchor's 'multiple specific concrete actions'.

5 / 5

Completeness

Clearly states what the skill does but has no 'Use when...' clause or equivalent trigger guidance; per the rubric guideline, a missing explicit trigger caps completeness at 3.

3 / 5

Trigger Term Quality

Includes natural terms a user would say ('cache', 'clear entries', 'cache statistics', 'TTL') but leans technical and omits common variations/synonyms like 'flush cache' or 'cache hit rate', fitting the 4-anchor's 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche (LLM response cache management) with minimal conflict risk against unrelated skills, though the absence of an explicit trigger phrase leaves minor overlap risk with neighboring admin/ops skills.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
diegosouzapw/OmniRoute
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.