CtrlK
BlogDocsLog inGet started
Tessl Logo

file-organizer

Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.

54

1.03x
Quality

30%

Does it follow best practices?

Impact

98%

1.03x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/file-organizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 communicates the general domain of file and folder organization with some useful action terms, but it lacks explicit trigger guidance ('Use when...') which is critical for skill selection. It also uses second-person voice ('your files,' 'your computer') and includes fluffy marketing language ('Reduces cognitive load,' 'without manual effort') that doesn't aid in skill selection.

Suggestions

Add an explicit 'Use when...' clause with trigger terms like 'organize files,' 'clean up folders,' 'find duplicate files,' 'restructure directory,' 'declutter desktop,' 'sort downloads.'

Remove marketing fluff like 'Reduces cognitive load' and 'without manual effort' — replace with concrete capabilities such as 'identifies and removes duplicate files, renames files by pattern, moves files into categorized subdirectories.'

Switch from second-person voice ('your files') to third-person voice ('Organizes files and folders') to match the expected style.

DimensionReasoningScore

Specificity

Names the domain (file/folder organization) and lists some actions like 'finding duplicates, suggesting better structures, automating cleanup tasks,' but these are still somewhat high-level rather than concrete specific operations (e.g., no mention of renaming, moving to specific directories, deduplication algorithms, etc.).

2 / 3

Completeness

Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent (not even implied well), this scores a 1.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'files,' 'folders,' 'duplicates,' 'cleanup,' and 'organize,' but misses common user phrasings like 'sort files,' 'clean up desktop,' 'declutter,' 'rename files,' 'directory structure,' or file extensions. Coverage of natural variations is incomplete.

2 / 3

Distinctiveness Conflict Risk

The focus on file/folder organization and duplicates provides some specificity, but phrases like 'understanding context' and 'automating cleanup tasks' are broad enough to overlap with general file management, system administration, or other organizational skills.

2 / 3

Total

7

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is significantly over-engineered and verbose for what it does. It explains many concepts Claude already understands (file types, folder structures, basic shell commands) and includes extensive examples and tips that inflate the token cost without proportional value. The workflow structure is reasonable but lacks concrete validation steps and portable, executable commands.

Suggestions

Cut content by at least 60%: remove 'When to Use', 'What This Skill Does', 'Pro Tips', 'Best Practices', 'Related Use Cases', and 'Common Organization Tasks' sections — these are either obvious to Claude or redundant with the instructions.

Split examples into a separate EXAMPLES.md file and reference it from the main skill, keeping only one brief example inline.

Add concrete verification steps after file moves (e.g., compare file counts before/after, verify checksums) and provide an actual undo script or log format rather than just mentioning it.

Fix platform-specific command issues: use `md5sum` vs `md5` conditionally, replace `find -printf` (Linux-only) with portable alternatives, and make commands copy-paste ready.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Explains obvious concepts Claude already knows (what file types are, what duplicates are, basic bash commands like ls and find). The 'When to Use This Skill' section, 'Pro Tips', 'Best Practices', 'Related Use Cases', and extensive examples are largely redundant padding. The 'What This Skill Does' section restates what the instructions already cover. Much of this could be cut by 60-70%.

1 / 3

Actionability

Provides some concrete bash commands (find, du, md5, mkdir, mv) but many are incomplete or semi-pseudocode (e.g., `[target_directory]` placeholders, `[custom command for their setup]`). The `find -printf` commands are Linux-specific and won't work on macOS. The md5 command syntax varies by OS. The workflow is more of a template than executable guidance.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and includes the important checkpoint of asking for confirmation before deleting. However, there's no explicit validation/verification step after moves are completed (e.g., verifying files arrived correctly, checking for broken symlinks). For destructive operations like file deletion and mass moves, the lack of an undo mechanism or verification step is a gap. The 'log all moves for potential undo' is mentioned but no concrete implementation is given.

2 / 3

Progressive Disclosure

Monolithic wall of text with no bundle files and no references to external files. Everything is inlined in a single massive document — the examples, best practices, common tasks, and pro tips could all be separate reference files. The content would benefit enormously from splitting into a concise SKILL.md overview with references to EXAMPLES.md, BEST_PRACTICES.md, etc.

1 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
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.