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

50%

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 ./bundled/skills/file-organizer/SKILL.md

Quality

Content

40%

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

The skill has a strong, well-gated multi-step workflow with real approval checkpoints, but it suffers from heavy verbosity, redundant overview sections, non-executable placeholders, and a monolithic structure with no progressive disclosure.

Suggestions

Collapse the redundant 'What This Skill Does', 'How to Use', and 'Common Organization Tasks' sections into a single concise overview to cut padding and re-explanation of concepts Claude already knows.

Replace placeholder commands ([target_directory], [custom command for their setup]) with concrete, executable examples and fix the duplicate-finding pipeline so it actually identifies duplicates.

Split the large examples and bash command library into reference files (e.g. references/commands.md, references/examples.md) and link them one level deep from SKILL.md to enable progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is verbose and padded—'What This Skill Does', 'How to Use', 'Common Organization Tasks', and 'Pro Tips' overlap heavily and re-explain file-organization concepts Claude already knows.	1 / 3
Actionability	Includes real executable commands (ls, find, du, mkdir, mv) but also non-executable placeholders like '[target_directory]', '[custom command for their setup]', and a duplicate-finding pipeline that does not actually work as written.	2 / 3
Workflow Clarity	A clear 7-step sequence runs from scope clarification through execution to summary, with explicit validation checkpoints—'Always confirm before deleting', 'Stop and ask if unexpected', 'Ready to proceed? (yes/no/modify)'—appropriate for destructive batch operations.	3 / 3
Progressive Disclosure	No bundle files exist and the skill is a ~430-line monolithic single file with no external references; content that could be split (examples, command library, naming conventions) is all inline.	1 / 3
	Total	7 / 12 Passed

Description

60%

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 enumerates concrete capabilities but is missing an explicit 'Use when...' trigger clause, which caps completeness and trigger-term quality. It reads as a capability list rather than a triggerable skill description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions a messy Downloads/Desktop folder, scattered files, duplicate files, or wants to restructure a directory.'

Include more natural user phrasings users would actually say ('organize my Downloads', 'find duplicate files', 'clean up my Desktop') to improve trigger-term coverage.

Tighten distinctiveness by naming the specific scope (e.g. 'across your home directory') versus general file handling.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions—'organizes your files and folders', 'finding duplicates', 'suggesting better structures', 'automating cleanup tasks'—matching the anchor for multiple specific concrete actions.	3 / 3
Completeness	Answers 'what' thoroughly but lacks any 'Use when...' clause or explicit trigger guidance; per the rubric a missing trigger clause caps completeness at 2.	2 / 3
Trigger Term Quality	Uses relevant terms like 'files', 'folders', 'duplicates', and 'cleanup' but omits common user phrasings such as 'messy Downloads folder', 'organize my Desktop', or 'find duplicate files'.	2 / 3
Distinctiveness Conflict Risk	The file/folder organization + duplicate niche is somewhat specific but broad enough to overlap with general file-handling or backup skills; not a 3-level distinct niche.	2 / 3
	Total	9 / 12 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: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/file-organizer/SKILL.md
Commit: f627ab5

Reviewed: about 8 hours 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.