CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cache-audit

Audit your Claude Code setup against prompt caching best practices. Checks ordering, tool stability, dynamic content handling, and hook injection patterns. Returns a scored report with specific fixes.

Quality

73%

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/agentic-harness/cache-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A strongly actionable audit skill with concrete files, thresholds, code, and an exact report template, sequenced clearly across six checks. Its weaknesses are redundancy (cheatsheet/Mindset/Anti-Patterns sections and author-specific asides) and an orphaned references/checklist.md that the body never points to, which undermine both conciseness and progressive disclosure.

Suggestions

Link the bundle reference from the body (e.g., "Full checklist: see [checklist.md](references/checklist.md)") and move the duplicated cheatsheet table and Anti-Patterns content into it, keeping SKILL.md as the lean overview.

Trim author-specific details ("like the personalOS repo", "granola meeting sync") into generic examples, and cut or compress the "Mindset" section since it restates ordering concepts the checks already encode.

Add explicit handling for missing inputs — what to report when ~/.claude/settings.json, hook files, or MCP configs are absent, and how to resolve Check 6's "MANUAL CHECK" outcome.

DimensionReasoningScore

Conciseness

The six checks themselves are tight and information-dense, but the body carries notable redundancy beyond them: a "Reference: The 6 Rules (Quick Cheatsheet)" table that restates all six checks, plus "Mindset" and "Anti-Patterns" sections that re-explain caching ordering concepts Claude already knows ("stable content first, volatile content last"). Author-specific details like "(like the personalOS repo)" and "granola meeting sync" also pad tokens without general use. This fits anchor 3 (mostly efficient but some unnecessary explanation that could be tightened) better than anchor 4's minor-instance bar.

3 / 5

Actionability

Every check names the exact files to read ("~/.claude/settings.json", "SessionStart and UserPromptSubmit hook files"), the exact pattern to verify ("hookSpecificOutput.additionalContext"), numeric thresholds ("< 2k chars ... 2k–10k ... > 10k chars"), a copy-paste-ready bash snippet for trimming git status, and a literal report template to emit. This matches anchor 5: fully executable, copy-paste-ready, covering the common cases.

5 / 5

Workflow Clarity

The sequence is unambiguous: "Run all checks automatically... produce the full report in one pass", then checks 1–6 in order, then a defined output format, with each check carrying its own PASS/WARNING/FAIL scoring criteria acting as evaluation checkpoints. It falls short of anchor 5 because there are no explicit feedback/validation steps — e.g., what to do when a listed file is missing, no hooks are configured, or a check is indeterminate (Check 6 ends in "MANUAL CHECK" with no instruction for how to resolve it).

4 / 5

Progressive Disclosure

Internal sectioning is decent (per-check headers, output format, cheatsheet), but the bundle contains references/checklist.md and the SKILL.md body never cites it — the single reference is present but not signaled at all, and checklist.md itself says "Core guidance is in SKILL.md" while nothing points back. Duplicated content (the cheatsheet table, anti-patterns) is inlined where the reference file would be the natural home. This matches anchor 3 (references present but not clearly signaled; content that should be separate is inline).

3 / 5

Total

15

/

20

Passed

Description

61%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 communicates a clear, concrete capability set with good natural keywords, but it is missing the 'when to use' half entirely, which caps completeness at 3, and its second-person opening ("Audit your setup") costs it specificity. Converting to third person and appending an explicit trigger clause would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to audit caching, reports lower-than-expected cache savings, or after changing the system prompt, tool list, or context ordering."

Rewrite in third person to avoid the second-person penalty: "Audits the user's Claude Code setup against prompt caching best practices..." instead of "Audit your Claude Code setup...".

Include the remaining check areas (model switching, compaction/fork safety) or natural trigger synonyms like "cache hit rate" to round out coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Audit your Claude Code setup", "Checks ordering, tool stability, dynamic content handling, and hook injection patterns", "Returns a scored report with specific fixes" — which would fit anchor 4 (several specific actions, minor gaps: model switching and compaction/fork checks are not mentioned). However, it opens with second-person voice ("Audit your Claude Code setup"), and the judging guidelines require reducing the specificity score by 1 for second-person phrasing, bringing it to 3.

3 / 5

Completeness

The "what" is clear and concrete (audits setup against caching best practices, names four check areas, returns a scored report with fixes), but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3, which matches anchor 3 exactly (clear 'what', 'when' missing).

3 / 5

Trigger Term Quality

Good natural-keyword coverage: "audit", "prompt caching", "cache", "Claude Code setup", "scored report" are phrases users would plausibly say. A few natural terms are missing — no trigger phrases like "cache hit rate", "why is my context expensive", or "am I breaking the cache" appear, so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The prompt-caching niche is fairly distinct — "against prompt caching best practices" with "hook injection patterns" is specific enough that it would not trigger for unrelated skills. Minor overlap risk remains with closely related skills (a generic Claude Code config/settings audit or performance-optimization skill could match the same requests), fitting anchor 4 rather than anchor 5's minimal-conflict clear niche.

4 / 5

Total

14

/

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

pantheon-org/tekhne

Path

skills/agentic-harness/cache-audit/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.