CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

remote-caching

Deep implementation details of HTTP-layer caching for remote file access: CachedFilelike, VirtualLRUBuffer, connection management algorithm, BrowserHttpReader, FetchReader streaming, and RequestQueue concurrency control.

Quality

65%

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 ./.github/skills/remote-caching/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-organized, technically dense reference document that accurately maps a complex subsystem, with clear pipeline sequencing and concrete constants throughout. Its weaknesses are that everything lives in one large SKILL.md body with no progressive disclosure to reference files, and it describes architecture more than it instructs actions.

Suggestions

Move the deep per-module internals (e.g. HydratedSourcePool lifecycle/eviction details, readerWeight.ts breakdown) into references/ files, keeping SKILL.md as a concise overview with well-signaled one-level-deep links.

Add an actionable quick-start section (e.g. how to tune cacheSizeInBytes / readAheadBufferBytes for a given session, or how to trace a slow remote read through the pipeline) so the skill instructs, not just describes.

Trim duplication between the per-section 'Source' paths and the 'Key Files Reference' table, and condense the longest sections to the decision-relevant facts.

DimensionReasoningScore

Conciseness

The body is dense and factual with little explanatory padding — it documents non-obvious internal constants, algorithms, and edge cases Claude could not infer — but at ~500 lines it is a large wall of reference detail for a SKILL.md, and sections like the 'Key Files Reference' table duplicate the per-section 'Source' paths already given. It is not a 4 because several sections (HydratedSourcePool, multi-file cache budget) run long and could be tightened or moved out of the main body.

3 / 5

Actionability

Concrete specifics are abundant (CACHE_BLOCK_SIZE = 10 MiB, READ_AHEAD_BUFFER_SIZE = 50 MiB, the 64 KiB / 4 MiB coalescing thresholds, and code excerpts of the real constructor logic), and a few actionable directives exist ('validate request-count reduction empirically', 'consider increasing totalCacheSizeInBytes'). It is not a 4 or 5 because the body primarily describes existing architecture rather than instructing a task — there is no executable workflow, command, or copy-paste-ready example for a user to follow.

3 / 5

Workflow Clarity

The full-pipeline diagram establishes a clear data-flow sequence from BrowserHttpReader up to IterablePlayer, and each subsystem's behavior is presented as coherent numbered steps (the CachedFilelike read flow, the VirtualLRUBuffer eviction algorithm, the getNewConnection decision cases, the acquire/release lifecycle). It is not a 5 because there are no explicit validation checkpoints or feedback loops, though the skill is descriptive reference material rather than a destructive multi-step task, so the missing-validation cap does not apply.

4 / 5

Progressive Disclosure

The body has good internal structure — clear per-module sections, each anchored to its real source file path — and the trailing 'Key Files Reference' table aids navigation. However, no references/ or other bundle files exist, so the deep per-module reference material (e.g. the HydratedSourcePool internals) is fully inlined in SKILL.md where one-level-deep reference files would be appropriate for a skill this size.

3 / 5

Total

13

/

20

Passed

Description

58%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 comprehensive about what the skill covers, anchored by concrete component names, but it reads as a table of contents rather than a usage-oriented description. Its main weaknesses are the complete absence of a 'when to use this' trigger clause and reliance on internal jargon over natural user phrases.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working on remote file playback, HTTP range-request caching, or the CachedFilelike/VirtualLRUBuffer pipeline in packages/suite-base'.

Include natural user-facing synonyms alongside the class names (e.g. 'remote MCAP playback', 'downloading remote files', 'presigned URL fetching') so the description matches how a user would phrase the need.

State at least one concrete action the skill enables (e.g. 'explains the connection-opening decision logic and cache budget distribution') rather than only listing components.

DimensionReasoningScore

Specificity

The description names the domain ('HTTP-layer caching for remote file access') and enumerates six concrete, specific components ('CachedFilelike, VirtualLRUBuffer, connection management algorithm, BrowserHttpReader, FetchReader streaming, and RequestQueue concurrency control'), giving comprehensive coverage of the skill's subject matter. It falls short of a 5 because the items are named topics/objects rather than concrete actions the skill performs.

4 / 5

Completeness

The 'what' is clear — deep implementation details of the caching pipeline and its named components — but there is no 'Use when...' clause or equivalent explicit trigger guidance for when Claude should reach for this skill, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is concrete and specific, not vague.

3 / 5

Trigger Term Quality

Phrases like 'HTTP-layer caching', 'remote file access', and 'concurrency control' are relevant keywords, but the language leans on internal jargon and omits natural user-facing variations a person would actually say (e.g. 'remote MCAP', 'downloading remote files', 'presigned URLs'). It is not a 4 because no synonyms or common casual phrasings of these terms appear.

3 / 5

Distinctiveness Conflict Risk

Enumerated internal class names (CachedFilelike, VirtualLRUBuffer, RequestQueue) make the skill highly distinguishable from unrelated skills. It is not a 5 because the opening phrase 'HTTP-layer caching for remote file access' is moderately generic and could overlap with other caching or network-fetch skills that lack those class names.

4 / 5

Total

14

/

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

skill_md_line_count

SKILL.md is long (503 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

lichtblick-suite/lichtblick

Path

.github/skills/remote-caching/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.