CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-organization

Guidelines and instructions for organizing files within the POS Cursor/POSCursor project and preventing root directory clutter.

56

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/file-organization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 body is a tight, well-organized, instruction-only ruleset that gives unambiguous placement rules for every file type it covers, with only minor padding in the intro and one vaguely defined phrase. It lacks only a verification step for link maintenance after file relocation.

DimensionReasoningScore

Conciseness

The body is a lean rule list with specific extensions and exceptions, but the opening sentence "This skill enforces file organization rules to prevent cluttering the project root directory and to keep the repository well-structured" restates the title and could be trimmed, matching the anchor for efficient content with minor over-explanation.

4 / 5

Actionability

Concrete directory mappings cover docs, scripts (with explicit extensions), SQL queries vs. migrations (with timestamp prefixes), images, and examples, plus a copy-paste link example (`[package.json](../package.json)`). The undefined escape hatch "or under specific component directories" leaves a minor gap, so it sits at anchor 4 rather than 5.

4 / 5

Workflow Clarity

As a simple single-purpose ruleset, the placement decision is unambiguous, but the link-relocation rule says "ensure" with no verification checkpoint for confirming links resolve after a move, matching the anchor for clear guidance with minor validation gaps.

4 / 5

Progressive Disclosure

The skill is under 50 lines, has no need for external references (none exist in the bundle), and is well-organized into two headed sections with numbered rules, which per the judging guidelines earns a 5 for simple skills.

5 / 5

Total

17

/

20

Passed

Description

50%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 names a concrete domain and outcome and is well-scoped to a specific project, but it describes the skill's contents ("Guidelines and instructions for") rather than concrete actions, and it entirely lacks a "Use when..." trigger clause. It reads as a content label rather than an invocation trigger.

Suggestions

Add an explicit trigger clause, e.g., "Use when creating, moving, or saving files in this repo, or when the root directory is cluttered."

Replace the meta-phrase "Guidelines and instructions for" with concrete actions, e.g., "Directs new files to their designated directories: docs go in docs/, scripts in scripts/, SQL in supabase/queries/, images in docs/images/."

Include natural trigger terms users would actually say, such as "where to put this file", "clean up the root", or "repo structure".

DimensionReasoningScore

Specificity

"Organizing files" is generic, but "preventing root directory clutter" is a concrete outcome, matching the anchor for a named domain with 1-2 concrete actions that are not comprehensive. It falls short of anchor 4 because no several specific actions (e.g., which file types go where) are listed.

3 / 5

Completeness

The description gives a moderately clear "what" (guidelines for organizing files and preventing clutter) but contains no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

"Organizing files" and "root directory clutter" are natural phrases a user might say, but common variations like "where to put this file", "clean up the root", or "repo structure" are missing, matching the anchor for some relevant keywords without common synonyms.

3 / 5

Distinctiveness Conflict Risk

The "POS Cursor/POSCursor project" scoping adds specificity, but the capability phrase "organizing files" is broad and would overlap with any general file-organization or repo-hygiene skill, matching the anchor for somewhat specific with residual overlap risk.

3 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

zazakia/JetFarm

Path

.agents/skills/file-organization/SKILL.md

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.