CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-filesystem

Use when agents need persistent shared storage, when saving or restoring workspace state, or when coordinating file access across multiple agents and machines. Creates Redis-backed workspaces, checkpoints and restores agent state, mounts shared filesystems locally, searches workspace contents, and forks workspaces for parallel work.

78

Quality

90%

Does it follow best practices?

Impact

100%

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, lean skill body: concrete executable commands for every flow, verification steps embedded in each sequence, and clean sectioned organization with one-level references. The main improvements are removing the redundant intro paragraph, adding brief error-recovery guidance for failed verifications, and moving Further Reading targets into the skill bundle so they ship with it.

Suggestions

Trim the opening paragraph, which duplicates the frontmatter description, and consolidate Key Points bullets that restate section content.

Add one or two error-recovery lines (e.g., what to check when './afs status' shows the mount is inactive or 'afs cp restore' fails) to close the feedback-loop gap.

Bundle the three Further Reading docs under references/ within the skill directory so the paths resolve wherever the skill is installed.

DimensionReasoningScore

Conciseness

The body is lean and command-first with no concept explanations, but the opening paragraph ("AFS is a workspace system for agents, backed by Redis. Use it when you want a durable workspace that still feels like normal files and directories...") restates the frontmatter description, and a few Key Points ("Redis is the source of truth", "Create checkpoints explicitly") overlap other sections. Anchor 4 (efficient, minor trimming possible) fits; anchor 5 would require every token to earn its place with zero redundancy.

4 / 5

Actionability

Every section gives copy-paste-ready commands covering the common cases: "./afs ws create my-project", "./afs ws mount my-project ~/my-project", "./afs fs grep --workspace my-project 'TODO auth'", "./afs cp create/restore", "./afs ws fork", including flag variants ("--path /src -E 'timeout|retry'"). This matches the anchor-5 example of fully executable commands covering common cases.

5 / 5

Workflow Clarity

Each flow has a clear sequence with explicit verification commands ("./afs ws list # verify the workspace exists", "./afs status", "./afs cp list # confirm the restore completed"), so the destructive restore operation is validated and the cap-at-3 rule does not apply. However there are no error-recovery feedback loops (no guidance on what to do when a verify step fails), which keeps it below anchor 5.

4 / 5

Progressive Disclosure

The body is a concise overview with well-labeled, one-level-deep pointers ("docs/guides/agent-filesystem.md — agent-facing usage guide", "docs/reference/cli.md — full CLI command reference", "docs/reference/mcp.md — MCP tool reference"), matching the anchor-5 pattern of well-signaled references. It falls to 4 because the referenced paths sit outside the skill bundle (no references/ directory exists, so the paths cannot be verified as real bundle files) — a minor organization gap.

4 / 5

Total

17

/

20

Passed

Description

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

An excellent description: concrete and comprehensive on capabilities, with an explicit multi-clause "Use when..." trigger that answers both what and when in third person. The only gap is a few missing natural synonyms (snapshot/backup) that would make trigger matching marginally more robust.

DimensionReasoningScore

Specificity

It lists five concrete actions — "Creates Redis-backed workspaces, checkpoints and restores agent state, mounts shared filesystems locally, searches workspace contents, and forks workspaces for parallel work" — which is comprehensive coverage of the skill's capabilities, matching the anchor-5 example. Anchor 4 requires minor gaps in coverage; none are evident.

5 / 5

Completeness

It explicitly answers both questions: the what is "Creates Redis-backed workspaces, checkpoints and restores agent state, mounts shared filesystems locally, searches workspace contents, and forks workspaces" and the when is the leading "Use when agents need persistent shared storage, when saving or restoring workspace state, or when coordinating file access across multiple agents and machines" — three concrete trigger clauses, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: "persistent shared storage", "saving or restoring workspace state", "coordinating file access", "multiple agents and machines", "checkpoints", "forks workspaces for parallel work". It falls short of anchor 5 because common synonyms users might say — e.g., "snapshot", "backup", "share files between agents", "resume work" — are absent.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (Redis-backed agent workspaces with checkpoints and forks) with triggers ("persistent shared storage", "coordinating file access across multiple agents and machines") that are unlikely to fire for unrelated skills, matching anchor 5's "clear niche with distinct triggers; minimal conflict risk".

5 / 5

Total

19

/

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

redis/agent-filesystem

Path

skills/agent-filesystem/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.