filesystem

Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot

Quality

51%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./src/opensquilla/skills/bundled/filesystem/SKILL.md

Quality

Content

48%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 skill body is action-rich with a solid CLI command reference, but it is padded with marketing and social sections, lacks validation checkpoints for batch/destructive operations, and does not split detail into reference files. It is functional but token-inefficient.

Suggestions

Remove the Updates & Community, Integration, and social-follow sections and trim duplicate examples to reduce padding.

Add an explicit batch-workflow sequence with validation checkpoints, e.g., run with --dry-run, review the planned operations, confirm, then execute and verify counts.

Move the full command reference and examples into separate reference files (e.g., REFERENCE.md, EXAMPLES.md) and keep SKILL.md as a concise overview that links to them.

Dimension	Reasoning	Score
Conciseness	The body is noticeably verbose: promotional Integration, Updates & Community, and social-follow sections, plus repeated example blocks that restate the command reference, add tokens Claude does not need.	2 / 5
Actionability	The command reference provides concrete, executable CLI invocations with per-flag explanations, though minor gaps (e.g., placeholder 'git clone <filesystem-skill-repo>') keep it from fully copy-paste ready.	4 / 5
Workflow Clarity	Commands are individually documented but batch/destructive operations (copy, --overwrite) lack an explicit validate-then-execute loop; --dry-run is shown as a flag rather than a checkpoint, capping this at 3 per the rubric.	3 / 5
Progressive Disclosure	The content is well sectioned, but everything (full command reference, examples, config) is inlined in a single file with no bundle/reference files to defer detail to, so it reads as a monolithic reference rather than an overview.	3 / 5
	Total	12 / 20 Passed

Description

55%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 clearly states what the skill does via a list of concrete operations, but lacks any 'when to use' trigger guidance and relies on generic rather than natural trigger terms. It is adequate but not exemplary.

Suggestions

Add an explicit 'Use when...' clause naming natural user phrases (e.g., 'Use when listing, searching, or batch-copying files, or analyzing directory structure').

Include common synonyms and concrete file extensions/patterns (e.g., '*.log', '*.js', find/grep-like tasks) to improve trigger term coverage.

Sharpen distinctiveness by tying the skill to a specific niche such as 'batch filesystem operations with dry-run safety' rather than generic 'filesystem operations'.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('listing, searching, batch processing, and directory analysis'), giving clear coverage of the skill's capabilities, though it stops short of a fully comprehensive enumeration.	4 / 5
Completeness	The 'what' is clear (advanced filesystem operations plus four action categories), but there is no 'Use when...' or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Relevant terms (listing, searching, batch processing) appear but they are generic action verbs rather than natural user phrasings, and no synonyms or file extensions are included.	3 / 5
Distinctiveness Conflict Risk	The 'filesystem operations' niche is named but the phrasing is broad and could overlap with other file-handling or search skills, so conflict risk is only moderate.	3 / 5
	Total	13 / 20 Passed

Validation

81%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	13 / 16 Passed

Repository: TokenRhythm/opensquilla
Path: src/opensquilla/skills/bundled/filesystem/SKILL.md
Commit: 94ac35e

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.