CtrlK
BlogDocsLog inGet started
Tessl Logo

filesystem-context

This skill should be used when agent work needs file-backed context: durable scratchpads, tool-output offloading, just-in-time discovery, cross-agent handoff files, filesystem memory, or cleanup policies for context stored outside the prompt.

61

Quality

77%

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/filesystem-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, actionable pattern catalog with concrete thresholds, commands, schemas, and a strong Gotchas section covering failure modes and remedies. The main weaknesses are redundancy (Integration duplicates the activation exclusions, Guidelines and Examples restate the patterns, an unnecessary metadata footer) and an orphaned executable script in the bundle that the body never points to.

Suggestions

Merge the Integration section into the When-to-Activate exclusions and drop the "Skill Metadata" footer, keeping one adjacency list instead of two and removing non-instructional tokens.

Reference `scripts/filesystem_context.py` in the body (e.g., under Pattern 1 or a new "Scripts" note with a Read-when trigger) so the executable implementation of the pseudocode snippets is discoverable, and replace the undefined-helper snippets with imports from it.

Consolidate the Guidelines list and the Examples section, which largely restate the patterns, into a single compact summary or move worked examples into `references/implementation-patterns.md`.

DimensionReasoningScore

Conciseness

The body is mostly efficient and does not explain concepts Claude already knows, but it could be tightened: the Integration section re-lists the same adjacent skills already excluded under When to Activate, the Guidelines recapitulate the six patterns, the Examples repeat pattern content, and a trailing "Skill Metadata" block adds no instructional value. This matches the anchor of mostly efficient with some unnecessary content, below the minor-trimming anchor 4.

3 / 5

Actionability

Concrete guidance is prevalent: specific grep invocations (`grep -A 5 "error" terminals/1.txt`), a YAML plan schema, directory layouts, and the ~2000-token offload threshold. The Python snippets are illustrative pseudocode with undefined helpers (`write_file`, `extract_summary`, `load_yaml`) rather than copy-paste ready, and the executable bundle script `scripts/filesystem_context.py` is never referenced, which are minor gaps characteristic of anchor 4 rather than the fully-executable anchor 5.

4 / 5

Workflow Clarity

Decision workflows are clear: explicit Use/Avoid criteria, a Token Accounting section that functions as a measure-before/after feedback loop, and a Gotchas section that pairs each failure mode with a concrete remedy (e.g., existence checks before reading cached paths). Patterns are presented as a catalog rather than sequenced step-by-step workflows with explicit validation checkpoints, which keeps it below anchor 5 but above the checkpoint-missing anchor 3.

4 / 5

Progressive Disclosure

Against the actual bundle, the single reference (`./references/implementation-patterns.md`) is well-signaled one level deep with a "Read when" trigger, and the body is clearly sectioned. However `scripts/filesystem_context.py` exists in the bundle yet is never referenced anywhere in SKILL.md, and some inline Examples/Guidelines content overlaps what could live in the reference — minor organization gaps that define anchor 4 rather than the clean-split anchor 5.

4 / 5

Total

15

/

20

Passed

Description

75%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, specific description with an explicit trigger clause and a concrete enumeration of use cases. Its main weakness is that the capability list is noun-based and doubles as both the 'what' and the 'when', leaving what the skill actually instructs implied rather than stated, and it lacks synonym-level keyword coverage.

Suggestions

Lead with one explicit third-person action sentence for the 'what' (e.g., "Implements filesystem-backed context patterns: scratch pads, tool-output offloading, plan persistence, sub-agent file handoff") before the 'Use when' clause, so 'what' and 'when' are both explicit.

Add natural synonyms and concrete artifacts users might mention, such as "context files", "scratch files", "plan files", or "tool output logs", to broaden trigger coverage.

State what the skill contains (patterns, code examples, gotchas, file-organization guidance) so the description distinguishes its depth from adjacent skills like memory-systems or context-compression.

DimensionReasoningScore

Specificity

The description enumerates six concrete capability areas ("durable scratchpads, tool-output offloading, just-in-time discovery, cross-agent handoff files, filesystem memory, or cleanup policies") rather than vague filler, but it names contexts as nouns without ever stating the actions the skill performs, which keeps it below the comprehensive anchor 5 and just above the 1-2-actions anchor 3.

4 / 5

Completeness

The 'when' is explicit with concrete trigger conditions ("This skill should be used when agent work needs file-backed context: ..."), but the 'what' is only implied through the noun enumeration rather than explicitly stated as a capability sentence, which is exactly the anchor-4 pattern of both present with one weaker.

4 / 5

Trigger Term Quality

It includes multiple natural terms an agent developer would actually say ("scratchpads", "tool-output offloading", "cross-agent handoff", "filesystem memory"), matching the good-coverage anchor, but it offers no synonyms or variations of these phrases, so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The scope is narrowed to "file-backed context" and "context stored outside the prompt", a clear niche with distinct triggers; there is minor overlap risk with adjacent memory and context-compression skills, so it fits the mostly-distinct anchor rather than the minimal-conflict anchor 5.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.