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.

Quality

58%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./file-organizer/SKILL.md

Quality

Content

50%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 provides actionable, executable commands and a clear workflow, but it is significantly verbose with duplicated content and lacks post-execution validation despite being a destructive batch operation. Progressive disclosure is hindered by a monolithic inline structure.

Suggestions

Remove duplicated example prompts — keep them in either 'How to Use' or 'Common Organization Tasks', not both — and trim the long templated output blocks.

Add an explicit post-execution verification step (e.g., re-list the destination and confirm file counts/sizes match) with a fix-and-retry loop to lift workflow clarity past the destructive-skill cap.

Move the detailed examples and template outputs into a separate reference file (e.g. references/organization-templates.md) and link to it from SKILL.md to improve progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The ~430-line body is noticeably verbose: the same example prompts are duplicated across 'How to Use' and 'Common Organization Tasks', 'What This Skill Does' repeats the description, and long templated markdown outputs pad the document with several unnecessary sections.	2 / 5
Actionability	It supplies concrete, executable bash commands (ls, find, du, md5, mv, mkdir) for analysis, deduplication, and execution, with only minor gaps from placeholder tokens like [target_directory].	4 / 5
Workflow Clarity	The seven-step process is clearly sequenced with confirmation gates before destructive actions, but as a destructive/batch skill it lacks explicit verify-after-move validation or a fix-and-retry feedback loop, capping the score at 3 per the rubric.	3 / 5
Progressive Disclosure	The body is well-structured with clear section headers, but at ~430 lines everything (long examples, templates, best practices) is inlined in SKILL.md with no references to separate files, so content that should be split stays inline.	3 / 5
	Total	12 / 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 is specific and mostly distinct, but it omits any explicit 'when to use' trigger guidance, which caps its completeness. Trigger-term coverage is good but could be broadened with common synonyms and concrete locations.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to organize, declutter, or deduplicate files and folders (e.g. Downloads, Documents, Desktop).'

Broaden trigger terms with natural synonyms and concrete locations users mention ('Downloads folder', 'find duplicates', 'clean up', 'tidy up').

Name archiving and renaming as distinct capabilities to round out the action list.

Dimension	Reasoning	Score
Specificity	The description lists several concrete actions — 'finding duplicates, suggesting better structures, and automating cleanup tasks' alongside 'organizes your files and folders' — giving clear coverage with only minor gaps (e.g., renaming and archiving not named as distinct actions).	4 / 5
Completeness	The 'what' is clearly and comprehensively answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	It includes natural user phrasings like 'organizes your files and folders', 'finding duplicates', and 'cleanup tasks', but lacks common synonyms and file/folder specifics (e.g., 'Downloads', 'Desktop') that would push it to comprehensive.	4 / 5
Distinctiveness Conflict Risk	The file/folder organization, deduplication, and cleanup niche is mostly distinct with minor overlap risk against closely related file-management skills.	4 / 5
	Total	15 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: ComposioHQ/awesome-claude-skills
Path: file-organizer/SKILL.md
Commit: be2a406

Reviewed: 3 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.