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 significantly hurts completeness. The language leans toward marketing copy ('Reduces cognitive load,' 'without manual effort') rather than precise capability listing, and it uses second-person voice ('your files,' 'your computer'), which reduces clarity for skill selection.

Suggestions

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to organize files, clean up directories, find duplicate files, restructure folders, or tidy up their desktop.'

Replace marketing language ('Reduces cognitive load,' 'without manual effort') with additional concrete actions like 'renames files by convention, moves files into categorized folders, identifies and removes duplicate files.'

Switch from second-person ('your files') to third-person voice ('Organizes files and folders') to align with description conventions.

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 the 'when' is not even implied clearly, so this scores at 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,' 'declutter,' 'rename,' 'directory structure,' 'messy desktop,' or file extensions. Also lacks explicit trigger guidance.

2 / 3

Distinctiveness Conflict Risk

The focus on file/folder organization and duplicates provides some distinctiveness, 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 template/example sections that bloat the token count without proportional value. The core workflow is reasonable but lacks proper validation checkpoints and the entire document should be restructured with progressive disclosure.

Suggestions

Cut the content by 60-70%: remove 'When to Use This Skill', '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 detailed examples into a separate EXAMPLES.md file and reference it from the main skill, keeping only one brief example inline.

Add explicit verification steps after file moves (e.g., confirm file counts match, verify no data loss) and provide a concrete undo mechanism (e.g., generating a shell script that reverses all moves).

Fix platform-specific commands: note that `md5` vs `md5sum`, `find -printf` vs `stat` differ across macOS/Linux, or provide cross-platform alternatives.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Explains obvious concepts Claude already knows (what file types are, what duplicates are, basic bash commands like mkdir and mv). Sections like 'When to Use This Skill', 'Pro Tips', 'Best Practices', 'Related Use Cases', and 'Common Organization Tasks' are largely redundant padding. The 'What This Skill Does' section restates what the instructions already cover.

1 / 3

Actionability

Provides some concrete bash commands (find, du, md5) and example folder structures, but many commands are incomplete or platform-specific without noting it (e.g., `md5` is macOS-specific, `find -printf` is GNU-specific). The workflow is more of a template/guide than executable code—much of it is markdown templates for presenting plans rather than actual automation scripts.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and includes confirmation before deletion, which is good. 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 deleting duplicates, the feedback loop is implicit ('always ask for confirmation') rather than structured with explicit rollback or undo mechanisms.

2 / 3

Progressive Disclosure

Monolithic wall of text with no bundle files or external references. Everything is inlined into a single massive document—the examples, best practices, pro tips, common tasks, and detailed instructions could all be split into separate files. There's no layered structure; a user asking for simple Downloads cleanup gets the same 300+ lines as someone restructuring their entire system.

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.