CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

filesystem-context

Use for file-based context management, dynamic context discovery, and reducing context window bloat. Offload context to files for just-in-time loading.

Quality

63%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/filesystem-context/SKILL.md

The canonical home for this skill is filesystem-context in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

42%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 well-structured, readable overview of filesystem-based context patterns whose main costs are verbosity (re-explaining concepts and tools Claude already knows) and illustrative rather than executable code. The dangling 'Implementation Patterns' reference and absence of any real reference files leave progressive disclosure underdeveloped.

Suggestions

Cut or drastically compress sections that re-teach Claude what it already knows: the ls/glob/grep basics, the static-vs-dynamic primer, and the four-failure-modes essay.

Make code snippets executable or explicitly label them illustrative: define or replace 'extract_summary', 'write_file', 'load_yaml', and the undefined 'tool_name'/'timestamp' variables with real implementations or shell commands.

Either create the referenced 'Implementation Patterns' file with a proper relative link and path, or remove the dangling reference and split the six pattern sections into reference files.

Turn the guidelines list into a sequenced workflow with checkpoints: measure token usage → offload outputs above a threshold → verify retrieval works → clean up scratch files.

DimensionReasoningScore

Conciseness

Multiple sections explain what Claude already knows: the static-vs-dynamic primer, the 'Core Concepts' failure-modes essay, and 'Models are specifically trained to understand filesystem traversal' followed by definitions of ls/glob/grep basics — matching the 'noticeably verbose; several unnecessary explanations' anchor. Not 3 because the padding is not incidental; entire sections (search-technique basics, restated problem/solution framing per pattern) could be cut without losing guidance.

2 / 5

Actionability

The YAML plan template, directory layouts, and grep command are concrete, but the Python snippets invoke undefined names ('tool_name', 'timestamp', 'extract_summary', 'write_file', 'load_yaml') making them pseudocode rather than executable — matching the 'some concrete guidance but incomplete; pseudocode' anchor. Not 4 because the undefined helpers in the flagship implementation snippets are more than minor gaps.

3 / 5

Workflow Clarity

Each pattern follows a coherent problem→solution→implementation shape and numbered guidelines exist, but there is no end-to-end sequenced workflow with checkpoints; 'Optimize based on measurements, not assumptions' is a directive without any validation step. Matching anchor 3 ('sequence present but checkpoints missing or implicit'). Not 4 because no explicit verify/measure step is provided anywhere.

3 / 5

Progressive Disclosure

The body is well-sectioned and reads as an overview of six patterns, but the single internal reference ('Implementation Patterns - Detailed pattern implementations') is a bare bullet with no path or link, and no such file exists in the bundle — matching the 'references present but not clearly signaled' anchor 3. Not 4 because ~300 lines of pattern detail that belong in reference files are inlined alongside a dangling reference.

3 / 5

Total

11

/

20

Passed

Description

67%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 solid description that answers both what and when with an explicit 'Use for' clause and domain-specific vocabulary. Its main weakness is trigger phrasing that leans toward the author's jargon ('dynamic context discovery', 'just-in-time loading') rather than the natural phrases a user would actually say when hitting context limits.

Suggestions

Add natural trigger phrases users would actually say, e.g., 'Use when the context window is filling up, tool outputs are too large, or state must persist across sessions.'

Replace one jargon term (e.g., 'dynamic context discovery') with a concrete user-visible scenario such as 'when grep-ing saved tool output beats re-reading it into context'.

Include a couple of concrete triggering situations (sub-agent sharing, long plans, terminal logs) to sharpen the 'when' beyond category names.

DimensionReasoningScore

Specificity

Names the domain and several distinct actions ('file-based context management', 'dynamic context discovery', 'reducing context window bloat', 'offload context to files'), matching the 'several specific actions with minor gaps' anchor. Not 5 because the actions are conceptual phrases rather than fully concrete operations like the PDF extraction exemplar.

4 / 5

Completeness

Both parts are present: a clear 'what' ('Offload context to files for just-in-time loading') and an explicit 'Use for...' trigger clause ('Use for file-based context management, dynamic context discovery, and reducing context window bloat'). Not 5 because the when lacks concrete trigger moments a user or Claude would recognize (e.g., 'when tool outputs exceed N tokens' or 'when the context window is filling up'); not 3 because the explicit 'Use for' clause exceeds weakly implied.

4 / 5

Trigger Term Quality

'context window bloat' and 'context' are relevant keywords users may say, but 'dynamic context discovery' and 'just-in-time loading' are technical jargon, and common natural phrasings (e.g., 'context window is full', 'too many tokens', 'save output to a file') are missing — matching the 'some relevant keywords but missing common variations' anchor. Not 4 because the missing terms are ones a user would plausibly say, not edge-case synonyms.

3 / 5

Distinctiveness Conflict Risk

The file-based context offloading niche is clearly distinguishable from most skills, with distinct trigger territory around context bloat and just-in-time loading. Not 5 because it overlaps with closely related context-engineering skills the collection itself references (context-optimization, memory-systems), creating some trigger competition.

4 / 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/filesystem-context/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.