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.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/skill-creator/SKILL.md

Quality

Content

67%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 content is a well-structured, actionable guide with clear sequencing, validation feedback, and genuine one-level-deep references to real bundle files. Its main weakness is conciseness — several sections restate familiar concepts and could be trimmed to better honor the token-budget principle it itself advocates.

Suggestions

Trim the explanatory restatements of what skills are and how the context window works, since these are concepts Claude already knows — lead with the actionable guidance instead.

Tighten the 'Core Principles' section into concise imperatives rather than multi-paragraph prose to reduce token cost while preserving the decision guidance.

Consider externalizing the worked examples in Steps 1–2 into a reference file and keeping only the selection guidance inline, to better model the progressive-disclosure patterns the skill teaches.

Dimension	Reasoning	Score
Conciseness	The body is mostly substantive but re-explains concepts Claude already knows (e.g., 'Skills are modular, self-contained packages...') and includes prose-heavy principle sections that could be tightened, matching the 'mostly efficient but some unnecessary explanation' anchor.	3 / 5
Actionability	Provides concrete executable commands (init_skill.py, package_skill.py with full argument examples) and concrete worked examples (image-editor questions, pdf-editor analysis), with only minor gaps in coverage.	4 / 5
Workflow Clarity	The 6-step process is clearly ordered with explicit skip conditions, and the packaging step includes a validation feedback loop (validate → fix → re-run), though testing checkpoints for added scripts are only briefly mentioned.	4 / 5
Progressive Disclosure	Detailed material is split into real, one-level-deep bundle files (references/workflows.md, references/output-patterns.md, scripts/*.py) that are clearly signaled from the body, with only minor organization gaps in how some inline material could itself be externalized.	4 / 5
	Total	15 / 20 Passed

Description

82%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 cleanly answers both what and when in third person with a distinct trigger niche. Its main weakness is specificity — it lists resource categories but only two generic actions (create/update) rather than enumerating the concrete skill-building activities it guides.

Suggestions

Expand the action list beyond 'create'/'update' to concrete activities the skill guides (e.g., 'plan reusable scripts, references, and assets', 'validate and package skills into .skill files', 'iterate based on real usage').

Add a natural synonym or phrasing variant (e.g., 'build a skill', 'scaffold a new skill') to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and lists concrete content categories ('specialized knowledge, workflows, or tool integrations') but only offers two generic actions ('create'/'update'), so it lands between the 3 and 4 anchors rather than achieving comprehensive action coverage.	3 / 5
Completeness	Explicitly answers both what it does ('Guide for creating effective skills...extends Claude's capabilities') and when to use it ('This skill should be used when users want to create a new skill...') with concrete trigger phrasing.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ('create a new skill', 'update an existing skill') plus domain keywords, giving good coverage though a few synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	'Create/update a skill' is a clear, narrow niche with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	17 / 20 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
relative_links	Relative link issues: 6 missing	Warning
referenced_paths_exist	Referenced path issues: 12 missing	Warning

	Total	14 / 16 Passed

Repository: heshengtao/super-agent-party
Path: skills/skill-creator/SKILL.md
Commit: b3af7a0

Reviewed: 12 days 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.