CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

check-cache-bugs

Audit Claude Code setup for cache bugs (CC#40524): sentinel, --resume/--continue, attribution header + ArkNill B3/B4/B5

55

Quality

69%

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 ./examples/skills/check-cache-bugs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 highly actionable audit procedure with excellent executable commands and a clear phased workflow, undermined by significant redundancy — bug explanations are repeated across the Background, Instructions, and Output format sections — and by a monolithic structure with no progressive disclosure. Time-sensitive version details will also age poorly without a dated section.

Suggestions

Deduplicate bug explanations: keep mechanism/root-cause details in one place (Background) and have the Output format template reference statuses only, rather than restating root causes and B4/B5 descriptions.

Split the Background (bug details, fix-status table) and the full Output format template into a references/ file, keeping SKILL.md to the phased instructions and a compact output skeleton.

Consolidate the time-sensitive version-number tables into a clearly dated 'Fix status (as of v2.1.92)' section so the skill ages gracefully and the instructions reference it rather than repeating version ranges inline.

DimensionReasoningScore

Conciseness

The same bug mechanisms are explained three times — in the Fix Status table, in the Background bullets, and again (nearly verbatim for Bug 2 and B4/B5) inside the Output format template — and time-sensitive version numbers pervade the whole file rather than being quarantined in a dated/deprecated section. Not 3 because the Background section and the output template are each substantial duplicated padding; not 1 because the Instructions phases themselves are lean and information-dense.

2 / 5

Actionability

Every phase gives copy-paste-ready bash commands (exact grep patterns, file paths, a per-binary loop) plus explicit version-threshold decision rules mapping each result to a specific flag and status. The output format is a concrete fill-in template covering all branches. Fully executable with no gaps for the common cases.

5 / 5

Workflow Clarity

Phases 1-5 are clearly sequenced ('Run all phases in order, collect every result, and produce the final report') with per-phase decision logic and a defined output format; the audit is read-only, so the destructive/batch validation cap does not apply. Not 5 because there are no explicit validation or verification checkpoints (e.g., cross-checking Phase 1's version against per-binary results in Phase 5, or confirming grep coverage before reporting).

4 / 5

Progressive Disclosure

The file is well-sectioned with headers, but it is a ~300-line monolith with no bundle files at all — the Background (bug explanations, fix-status tables) and the large Output format template are inlined content that would sit better in a separate reference file loaded on demand. Not 4 because content that clearly belongs in separate files is inline; not 2 because section structure and navigation within the file are clear.

3 / 5

Total

14

/

20

Passed

Description

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

A specific, distinctive description that clearly states what the skill audits, but it lacks any "Use when..." trigger guidance and relies on issue-tracker jargon rather than natural user phrasing. Adding an explicit use-case clause and user-facing synonyms would raise it substantially.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when the user mentions Claude Code cache issues, high token costs, or cache hit rates, or asks to check for CC#40524.'

Include natural trigger synonyms users would actually say, such as 'cache miss', 'cache hit rate', 'expensive sessions', and 'token cost'.

Replace or gloss internal jargon (e.g., 'ArkNill B3/B4/B5') with plain-language bug names so the description is meaningful to someone who has not read the issue thread.

DimensionReasoningScore

Specificity

"Audit Claude Code setup for cache bugs" names the domain and action, and enumerates specific items ("sentinel, --resume/--continue, attribution header + ArkNill B3/B4/B5") that map to what is actually checked. Not 5 because the enumerated items are bug identifiers rather than a comprehensive list of concrete audit actions (e.g., version check, config scan, binary inspection).

4 / 5

Completeness

The "what" is clear (audit Claude Code setup for specific cache bugs), but there is no "Use when..." clause or equivalent trigger guidance — the guidelines cap completeness at 3 in that case. Not 2 because the "what" half is concrete and specific.

3 / 5

Trigger Term Quality

Terms like "Claude Code", "cache bugs", and "--resume" are relevant, but the description leans on technical jargon ("CC#40524", "ArkNill", "sentinel", "attribution header") and omits natural user phrasings such as "cache hit rate", "token cost", or "expensive sessions". Not 4 because common synonyms a user would actually say are missing.

3 / 5

Distinctiveness Conflict Risk

The description targets a uniquely specific niche (a numbered GitHub issue and named bugs B1-B5), so it is clearly distinguishable from any other skill and would not trigger for the wrong skill. Not 4 because the trigger surface is this narrow and no overlap risk exists.

5 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

examples/skills/check-cache-bugs/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.