skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

1.17x

Quality

—

Does it follow best practices?

Impact

99%

1.17x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Quality

Content

85%

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-structured, actionable skill-creation workflow with real bundled scripts, explicit sequencing, and validation feedback loops. Its main weakness is conceptual padding in the introductory sections that assumes less of Claude's intelligence than necessary.

Suggestions

Tighten the 'About Skills' section by removing conceptual framing (e.g., the 'onboarding guides' / 'transform Claude from a general-purpose agent' passage) and retaining only the non-obvious structural facts about scripts, references, and assets.

Trim the 'What Skills Provide' and 'Progressive Disclosure Design Principle' sections to the essential rules, or move the detailed anatomy reference into a references/ file so SKILL.md stays a lean overview.

Reference scripts/quick_validate.py in the body (it exists in the bundle but is never mentioned), or remove it from the bundle so referenced and present files stay in sync.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with concrete commands and examples, but the 'About Skills' section contains conceptual padding such as 'Think of them as "onboarding guides"... they transform Claude from a general-purpose agent into a specialized agent equipped with procedural knowledge that no model can fully possess', matching the 'Mostly efficient but includes some unnecessary explanation' anchor rather than the lean level-3.	2 / 3
Actionability	It provides executable, copy-paste-ready commands ('scripts/init_skill.py <skill-name> --path <output-directory>', 'scripts/package_skill.py <path/to/skill-folder>') backed by real bundle scripts plus concrete worked examples (pdf-editor, frontend-webapp-builder, big-query), matching the 'Fully executable code/commands; specific examples; copy-paste ready' anchor.	3 / 3
Workflow Clarity	The six-step process is explicitly sequenced with skip-when guidance, and Step 5 includes a validation checkpoint with a feedback loop ('If validation fails... Fix any validation errors and run the packaging command again'), matching the 'Clear sequence with explicit validation steps; feedback loops for error recovery' anchor rather than the level-2 case with checkpoint gaps.	3 / 3
Progressive Disclosure	SKILL.md is a well-organized overview that signals one-level-deep bundled scripts (init_skill.py, package_skill.py) via concrete usage blocks, and the actual bundle confirms these files exist; this matches the 'Clear overview with well-signaled one-level-deep references' anchor rather than the level-2 case with content that should be separate left inline.	3 / 3
	Total	11 / 12 Passed

Description

90%

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 strong: it uses the recommended third-person voice, explicitly states both purpose and trigger conditions, and occupies a distinct niche. Its only weakness is that it describes the domain at a relatively abstract level rather than enumerating concrete actions.

Dimension	Reasoning	Score
Specificity	The description names the domain and some actions ('create a new skill (or update an existing skill)') but does not list multiple concrete capabilities, matching the 'Names domain and some actions, but not comprehensive' anchor rather than the level-3 'Lists multiple specific concrete actions'.	2 / 3
Completeness	It states what the skill does ('Guide for creating effective skills') and gives an explicit trigger in third person ('This skill should be used when users want to create a new skill (or update an existing skill)...'), satisfying both 'what' and 'when'; below this level the 'when' would be missing or only implied.	3 / 3
Trigger Term Quality	Phrases like 'create a new skill' and 'update an existing skill' are natural terms a user would actually say, giving good coverage of common variations; this is above level 2 which expects only some relevant keywords with missing variations.	3 / 3
Distinctiveness Conflict Risk	Skill creation is a clear, narrow niche with distinct triggers ('create a new skill', 'update an existing skill') unlikely to fire for unrelated skills; this matches the 'Clear niche with distinct triggers; unlikely to conflict' anchor rather than the level-2 'could still overlap' case.	3 / 3
	Total	11 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 12 missing	Warning

	Total	14 / 16 Passed

Repository: davepoon/buildwithclaude
Commit: 366e45b

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