create-skill

Expert guidance for creating, writing, building, and refining GSD skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

86%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, lean router-pattern SKILL.md with strong actionability and conciseness, plus a useful success criteria checklist. Its main defects are referencing workflow files that are absent from the bundle and keeping validation feedback loops out of the body.

Suggestions

Provide the missing workflows/ directory with the 9 named workflow files (e.g., create-new-skill.md, audit-skill.md, verify-skill.md) so the routing targets actually resolve, or remove references to workflows that do not exist.

Add explicit validate->fix->retry checkpoints inline for risky routed operations (audit, verify, upgrade-to-router) rather than deferring all validation to the workflow files.

Sharpen the description's action verbs so the listed capabilities are distinct rather than overlapping (e.g., separate 'design skill structure', 'write SKILL.md content', 'refine and audit existing skills').

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence, using terse lists and short statements with no padding or explanations of concepts Claude already knows; nearly every token earns its place.	3 / 3
Actionability	It provides concrete, copy-ready guidance: exact directory layouts, per-folder purposes, explicit intent-to-workflow routing, and the exact YAML frontmatter format with field meanings, so absence of code is not penalized for this instruction/router skill.	3 / 3
Workflow Clarity	The routing flow is clearly sequenced with an explicit clarifying-question protocol and a success_criteria checklist, but the body delegates the actual validate->fix->retry feedback loops to workflow files and lacks those checkpoints inline.	2.5 / 3
Progressive Disclosure	The overview is concise (~180 lines) with well-organized one-level-deep references (all 13 listed files exist), but it routes to a workflows/ directory and names 9 workflow files that do not exist in the bundle, breaking the disclosure chain.	2 / 3
	Total	10.5 / 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.

A strong, third-person description that covers what the skill does and when to use it with explicit triggers and natural keywords. Its only weakness is that the listed actions are somewhat overlapping and abstract rather than sharply distinct.

Dimension	Reasoning	Score
Specificity	The description names several actions ('creating, writing, building, and refining GSD skills'), but the verbs overlap and stay abstract rather than crisply distinct concrete operations, matching the 'names domain and some actions, but not comprehensive' anchor.	2 / 3
Completeness	It answers both 'what' (expert guidance for creating/writing/building/refining skills) and 'when' via an explicit 'Use when working with SKILL.md files, authoring new skills...' clause, mirroring the top anchor example.	3 / 3
Trigger Term Quality	It includes natural terms a user would say ('SKILL.md files', 'authoring new skills', 'improving existing skills', 'skill structure and best practices'), giving good coverage of common phrasings.	3 / 3
Distinctiveness Conflict Risk	The GSD-skill-authoring niche is specific with distinct triggers around SKILL.md files, making it unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: gsd-build/gsd-2
Path: src/resources/skills/create-skill/SKILL.md
Commit: 33c00aa

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