CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

filesystem

Finding and filing things in the home. Use when a thread builds on earlier work (a note, a draft, a past thread), or files, moves, or tidies files.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an exemplary lean, operational skill: concrete commands with real examples, a numbered discovery workflow, explicit safety guardrails around file moves and inbox handling, and a copy-paste template. The only meaningful gap is the absence of a post-move/post-commit verification checkpoint, which keeps workflow_clarity at 4 rather than 5. Structure and token efficiency are essentially ideal for a single-file skill of this scope.

DimensionReasoningScore

Conciseness

Every line is operational — commands, constraints, and a template — with zero concept explanation and zero padding; even dense bullets like the cross-repo commit instruction consist entirely of executable guidance. This matches anchor 5 ('every token earns its place') and is clearly above anchor 4, which reserves room for trimmable over-explanation.

5 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: `ls -t ~/scratch | head -20`, `rg -il "<words>" ~/projects ~/scratch ~/inbox`, `git -C ~/projects/<slug> add <files> && git -C ~/projects/<slug> commit -m "<what>"`, plus a concrete rename example (`mv ~/inbox/IMG_2041.pdf ~/projects/sell-the-car/title-scan.pdf`) and a fill-in AGENTS.md template. Matches anchor 5's 'specific examples cover the common cases'.

5 / 5

Workflow Clarity

The find-earlier-work workflow is a numbered 4-step sequence with concrete commands, and the risky operations carry explicit guardrails: 'never delete from ~/inbox unless asked', 'leave unmatched items in place', 'state which file you updated'. It is anchor 4 rather than 5 because there is no post-operation verification step (e.g., confirming a moved file landed at its destination); it is not capped at 3 because the skill forbids deletion outright rather than performing unvalidated destructive operations.

4 / 5

Progressive Disclosure

The skill is a single SKILL.md with no references/, scripts/, or assets/ directories, is 24 lines of body content (well under the 50-line threshold), and is organized under clear bold section labels (Find earlier work, Move don't copy, Commit changes, AGENTS.md, server-owned folders). Per the rubric's simple-skill guideline, this earns 5 with just well-organized sections; there are no buried or nested references to penalize.

5 / 5

Total

19

/

20

Passed

Description

66%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 has a clear, explicit 'Use when...' trigger clause with natural phrasing, but the capability statement itself is vague. Naming the concrete actions (search notes/drafts by text, move and rename files across ~/projects, ~/scratch, ~/inbox, update AGENTS.md) in the what-clause would lift both specificity and completeness. Distinctiveness is moderate — the thread-continuity framing helps, but generic file vocabulary creates overlap risk with general file-management skills.

Suggestions

Replace the vague what-clause 'Finding and filing things in the home' with concrete named actions, e.g. 'Searches notes, drafts, and past threads by text or title; moves and renames files across ~/projects, ~/scratch, and ~/inbox; maintains project AGENTS.md'.

Add the distinctive environment vocabulary (thread journal, ~/inbox, ~/projects, ~/scratch) to the trigger clause so the skill is less likely to collide with generic file-management skills.

Include common user phrasings as triggers — e.g. 'find my earlier work', 'search my notes', 'put this in the car-selling project' — to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The what-clause "Finding and filing things in the home" is generic, with the only concrete verbs ("files, moves, or tidies files") appearing in the when-clause, matching anchor 3's 'names domain and 1-2 concrete actions, but not comprehensive'. It is not 4 because the skill's actions are not enumerated where the capability is stated, and not 2 because the domain and file/move/tidy actions are explicitly named.

3 / 5

Completeness

Both parts are present: a what ("Finding and filing things in the home") and an explicit "Use when..." clause with concrete triggers ("a thread builds on earlier work... or files, moves, or tidies files"). It does not reach 5 because the what-half is vague and would need concrete, named actions to clearly answer both halves.

4 / 5

Trigger Term Quality

Includes natural phrases a user would say — "a note, a draft, a past thread", "files, moves, or tidies files" — giving good keyword coverage, though common variations like "find my notes", "search", or location names ("projects", "inbox") are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Things in the home" and "files" are broad enough to overlap with any generic file-management skill; the thread-journal framing ("a past thread") is the only distinctive hook, matching anchor 3's 'somewhat specific but could still overlap with similar skills'. It is not 4 because the dominant vocabulary (files, moves, tidies) is shared with common file skills.

3 / 5

Total

14

/

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

google/adk-samples

Path

core/python/adk-voice-agent/sandbox/skills/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.