CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-snippet-folders

Creates article-relative ./snippets/ directories and returns their paths. Use when a snippet workflow needs folders composed from an article path plus caller-selected platform, conflict-avoidance subject, and code-language segments.

Quality

75%

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 ./.github/skills/create-snippet-folders/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 well-organized, actionable, lean instruction set with a clear sequenced workflow and explicit validation for a batch folder-creation task. Its only meaningful gap is the absence of an explicit error-recovery feedback loop.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and avoids explaining basic concepts; there is minor repetition of segment rules across 'Caller Decision Guide' and 'Input', fitting 'efficient; minor instances that could be trimmed'; not a 5 because of that duplicated guidance.

4 / 5

Actionability

Provides a concrete path template ('./snippets/{article-name}/[platform]/[subject]/[language]/'), four input-to-output example mappings, and explicit validation rules; as an instruction-only skill the absence of code is not penalized, fitting 'mostly executable guidance with minor gaps'; not a 5 because reporting/error-detail format is left implicit.

4 / 5

Workflow Clarity

'Create the Structure' gives a clear numbered sequence (steps 1-6) with validation checkpoints (reject bad segments, leave existing dirs unchanged, return control on missing input), so the batch-operation cap does not apply; not a 5 because there is no explicit validate-fix-retry feedback loop.

4 / 5

Progressive Disclosure

The body is under ~50 lines, single-purpose, needs no external references, and is organized into clear sections (Caller Decision Guide, Input, Create the Structure, Example Requests), meeting the simple-skill exception for a top score; no bundle files exist to verify, consistent with a self-contained skill.

5 / 5

Total

17

/

20

Passed

Description

62%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 third-person, specific to a clear niche, and provides both a 'what' and a 'Use when' trigger. Its main weakness is jargon-heavy trigger language that limits natural keyword quality and keeps completeness just short of exemplary.

Suggestions

Rewrite the 'Use when...' clause with natural trigger phrases a user would actually say (e.g., 'Use when a docs snippet workflow needs per-article code-snippet folders'), reducing jargon like 'conflict-avoidance subject' and 'code-language segments'.

Add a synonym or file-extension trigger term (e.g., 'snippets', 'snippet folders') to broaden natural keyword coverage.

Briefly name one more concrete action (e.g., 'validates path segments before creating') to lift specificity toward several distinct actions.

DimensionReasoningScore

Specificity

Names two concrete actions ('Creates article-relative ./snippets/ directories and returns their paths') but stops there rather than listing several, matching the '1-2 concrete actions, but not comprehensive' anchor; not a 4 because it does not enumerate multiple specific actions.

3 / 5

Completeness

Explicitly answers both 'what' (creates directories and returns paths) and 'when' ('Use when a snippet workflow needs folders composed from...'), matching 'has both what and when; when could be more explicit'; not a 5 because the trigger clause is dense and jargon-laden rather than crisp concrete trigger phrases.

4 / 5

Trigger Term Quality

Contains relevant keywords ('snippet workflow', 'folders', 'article path', 'platform', 'code-language segments') but they skew toward technical jargon and miss common synonyms a user would naturally say, fitting 'some relevant keywords but missing common variations'; not a 4 because natural phrasing is sparse.

3 / 5

Distinctiveness Conflict Risk

Targets a narrow niche (documentation snippet folders built from article-relative paths with caller-selected segments), making it mostly distinct with only minor overlap risk against generic folder-creation skills; not a 5 because related path/folder skills could still overlap.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

dotnet/docs

Path

.github/skills/create-snippet-folders/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.