CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fractal-file-structuring

Use when creating, moving, splitting, or organizing TypeScript files and folders. Applies fractal tree file-structuring rules which reduce the cognitive overhead of choosing where to put files and ultimately navigating a codebase (once the structure is established and understood).

69

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

A well-crafted, highly actionable rule set: concrete naming and file-tree examples, a usable decision checklist, and clear section organization. The only weaknesses are mild repetition of the subtree-privacy rule and the absence of any verification step in the checklist.

DimensionReasoningScore

Conciseness

The body is dense rule-content with no padding about concepts Claude already knows and compact tree examples, but the subtree-privacy rule is restated across "Split outgrown files into private subtrees", "Keep private subtrees private", and "Put shared resources at the closest fork" (e.g., 'Only `editor-view.tsx` should import...' appears in multiple forms), which could be trimmed.

4 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: kebab-case example names, executable file-tree patterns, an avoid/prefer TypeScript import snippet, and a 7-item Decision Checklist plus a "When Unsure" decision table that cover the common cases copy-paste ready.

5 / 5

Workflow Clarity

The Decision Checklist ("1. Identify the semantic concept... 7. Co-locate tests") gives a clear ordered sequence with a fallback section, but there is no verification checkpoint (e.g., confirming no other file imports a private subtree after a move), so it sits below the explicit-validation anchor 5. No destructive/batch cap applies.

4 / 5

Progressive Disclosure

This is a single-file skill with no bundle files; every section is a core rule that belongs inline, headers are clear (Core Rules, Decision Checklist, When Unsure), and navigation is easy, so the single-file structure is appropriately split with nothing buried.

5 / 5

Total

18

/

20

Passed

Description

83%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.

A strong description with an explicit 'Use when' trigger clause listing four concrete actions and a clearly named methodology. Its main gaps are missing natural synonyms (JavaScript, file structure/naming) and a slightly abstract benefit clause.

DimensionReasoningScore

Specificity

The description lists four concrete actions ("creating, moving, splitting, or organizing TypeScript files and folders") plus a named mechanism ("Applies fractal tree file-structuring rules"), but the closing benefit clause ("reduce the cognitive overhead of choosing where to put files") is softer and less action-like, leaving minor gaps versus the comprehensive anchor 5.

4 / 5

Completeness

It explicitly answers "what" ("Applies fractal tree file-structuring rules which reduce the cognitive overhead of choosing where to put files") and "when" with a concrete "Use when creating, moving, splitting, or organizing TypeScript files and folders" trigger clause, matching the top anchor rather than anchor 4 whose 'when' is weaker.

5 / 5

Trigger Term Quality

Natural user phrases like "creating", "splitting", "organizing", and "TypeScript files and folders" are present, but common variations are missing — notably "JavaScript" (the skill body covers it), "file structure", "naming", and "where to put files" — so it falls just short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The TypeScript/JavaScript file-placement niche with "fractal tree" framing is mostly distinct, but generic triggers like "organizing files and folders" leave minor overlap risk with general code-organization or linting skills, keeping it below the minimal-conflict anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

hashintel/hash

Path

.agents/skills/fractal-file-structuring/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.