CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-builder-generic

Universal guide for creating production-ready Claude Code skills for any project. Includes 6-step workflow (understand, plan, initialize, edit, package, iterate), progressive disclosure design, YAML frontmatter templates, validation scripts, reference organization patterns, and 10 community-proven innovations. Use when creating new Claude Code skills, converting documentation to skills, improving existing skills, or learning skill development best practices for any domain.

Quality

82%

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

73%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-structured meta-skill with an excellent, clearly sequenced 6-step workflow, explicit validation checkpoints, and a genuine progressive-disclosure architecture backed by real reference and script files. Its weaknesses are verbosity — conceptual padding and in-body duplication of material that already exists in its own references/ — and minor actionability gaps such as the missing templates/ directory and a placeholder quick-start test step.

Suggestions

Consolidate the four in-body treatments of progressive disclosure (Core Principles, Step 2, the 'Progressive Disclosure Deep Dive' section, and 'Common Patterns Summary') into a brief principle plus a link to references/progressive-disclosure-architecture.md, and do the same for the twice-repeated imperative-voice good/bad examples.

Cut concept explanations Claude already knows ('What Are Claude Code Skills?', 'Why Skills Matter', the 'Context Window Optimization' token-math illustration) and move the thin '10 Community Innovations' section into a reference file, keeping SKILL.md to the workflow, patterns, quick start, and tooling.

Fix actionability gaps: replace the 'Test (30 seconds)' quick-start step with a concrete verification action, fill in the placeholder quick-start steps ('First step', 'Second step'), and either add the templates/ directory or point users to 'python scripts/init-skill.py skill-name --template <pattern>' instead of the non-existent templates/ directory.

DimensionReasoningScore

Conciseness

At ~3,300 words the body is mostly useful, actionable material (scaffolding commands, checklists, decision tree, script usage), but it carries noticeable padding: conceptual sections Claude already knows ('What Are Claude Code Skills?', 'Why Skills Matter', the token-math 'Context Window Optimization' example), and in-body duplication — progressive disclosure is explained in 'Core Principles', Step 2, a full 'Deep Dive' section, and again in 'Common Patterns Summary', while imperative-voice good/bad examples appear in both Step 4 and 'Core Principles'. Not 2 because the majority of sections deliver concrete, non-redundant instruction; not 4 because the duplication and concept-explanation sections are real trim targets, and the '10 Community Innovations' section is ~90 lines of thin one-liner content that belongs in a reference.

3 / 5

Actionability

Guidance is mostly executable: copy-paste-ready bash scaffolding (mkdir, heredoc SKILL.md creation), concrete script invocations ('python scripts/init-skill.py skill-name --template workflow', 'python scripts/validate-skill.py skill-name/'), and a worked 5-minute quick start. Not 5 because of minor gaps: the quick-start 'Test (30 seconds)' step is only a comment with no concrete verification action, the quick-start template body is placeholder text ('First step', 'Second step'), and 'See templates/ directory for 5 ready-to-use patterns' points to a directory that does not exist in the bundle.

4 / 5

Workflow Clarity

The 6-step creation process is clearly sequenced, each step declares an Objective and an explicit Output, Step 5 is a dedicated validation checkpoint with 32 enumerated checks plus automated validation commands and documented exit codes, and Step 6 plus the Troubleshooting section provide feedback loops for error recovery. This matches the anchor: clear sequence, explicit validation steps, checklists for a complex process, and iteration based on results.

5 / 5

Progressive Disclosure

Scored against the actual bundle: all 8 references/ files cited from the body exist and are one level deep, clearly signaled with 'See [references/x.md] for...' patterns, and the 4 scripts/ files are documented with usage and features in an 'Automation Tools Overview'. Not 5 because 'See templates/ directory for 5 ready-to-use patterns' is a broken pointer (no templates/ directory in the bundle — templates are embedded in init-skill.py), and several inlined sections ('Progressive Disclosure Deep Dive', '10 Community Innovations', the 12+10+10 validation checklists) duplicate content that already lives in references/ and should have been referenced rather than inlined. Not 3 because the overall split between lean overview and on-demand detail is genuinely good.

4 / 5

Total

16

/

20

Passed

Description

88%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 that follows the What + Features + Triggers formula it teaches: capabilities are enumerated concretely, and an explicit 'Use when...' clause lists four concrete trigger scenarios. The only deductions are a few missing natural trigger variations and slightly broad 'any project/any domain' phrasing.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities: '6-step workflow (understand, plan, initialize, edit, package, iterate), progressive disclosure design, YAML frontmatter templates, validation scripts, reference organization patterns, and 10 community-proven innovations'. This is comprehensive coverage with named, specific components rather than vague claims. Not 4 because the enumeration is thorough and names even the sub-steps of the workflow, leaving no notable coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: what it does ('Universal guide for creating production-ready Claude Code skills... Includes 6-step workflow...') and when to use it ('Use when creating new Claude Code skills, converting documentation to skills, improving existing skills, or learning skill development best practices'). Concrete trigger phrases accompany the 'when' clause, matching the anchor-5 example structure. Not 4 because the 'when' is already explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Triggers include natural user phrases like 'creating new Claude Code skills', 'converting documentation to skills', 'improving existing skills', and 'skill development best practices'. Not 5 because a few natural terms users might say are absent (e.g., 'SKILL.md', 'skill template', 'write a skill'); not 3 because coverage goes well beyond a bare domain mention and includes verb-form variations.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (authoring Claude Code skills) with distinct triggers around skill creation/conversion, so it is unlikely to fire for unrelated skills. Not 5 because the broad qualifiers 'for any project' and 'for any domain' slightly widen the trigger surface, creating minor overlap risk with general documentation-authoring or prompt-engineering skills.

4 / 5

Total

18

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (998 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

12

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/skill-builder-generic/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.