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.25x

Quality

80%

Does it follow best practices?

Impact

79%

1.25x

Average score across 7 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

77%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 delivers a well-sequenced, validated workflow with executable commands and clean one-level-deep reference structure; its main weakness is conceptual padding and analogies that assume too little of Claude's intelligence.

Suggestions

Remove explanatory analogies and conceptual framing Claude already knows (e.g., the "narrow bridge / open field" metaphor and the "onboarding guides" characterization) to tighten conciseness toward the lean anchor.

Trim the "What Skills Provide" and "Core Principles" narrative commentary down to imperative guidance, keeping only non-obvious procedural rules.

Surface scripts/quick_validate.py from SKILL.md (or note it as an internal helper) so every bundle file is clearly signaled.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient procedural guidance but includes unnecessary conceptual padding such as the bridge metaphor ("a narrow bridge with cliffs needs specific guardrails") and the "onboarding guides" framing that Claude does not need, matching the mostly-efficient-but-could-be-tightened anchor.	3 / 5
Actionability	Copy-paste-ready commands ("scripts/init_skill.py <skill-name> --path <output-directory>", "scripts/package_skill.py <path/to/skill-folder>") plus concrete worked examples (pdf-editor, frontend-webapp-builder, big-query) give mostly executable guidance with minor gaps in the high-level "Edit the skill" step.	4 / 5
Workflow Clarity	A clearly ordered 6-step process with explicit validation ("Added scripts must be tested by actually running them", packaging "automatically validates") and a feedback loop ("Fix any validation errors and run the packaging command again") matches the clear-sequence-with-validation-and-recovery anchor.	5 / 5
Progressive Disclosure	Detailed material is split into well-signaled one-level-deep references ("See references/workflows.md", "See references/output-patterns.md") that exist as real bundle files, with the body kept under the 500-line limit, matching the clear-overview-with-one-level-references anchor.	5 / 5
	Total	17 / 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 clearly states what the skill does and when to use it with natural trigger phrases and a distinct niche, though the action list is limited to create/update rather than enumerating the full range of skill-authoring actions.

Dimension	Reasoning	Score
Specificity	Quotes "Guide for creating effective skills" and "create a new skill (or update an existing skill)" name the domain plus two concrete actions but stop short of listing multiple specific actions, matching the anchor for 1-2 concrete actions rather than the comprehensive list at 5.	3 / 5
Completeness	It gives a clear "what" ("Guide for creating effective skills") and an explicit concrete "when" ("This skill should be used when users want to create a new skill (or update an existing skill)"), satisfying the anchor for explicitly answering both with trigger phrases.	5 / 5
Trigger Term Quality	Natural phrases "create a new skill" and "update an existing skill" are exactly what a user would say, giving good keyword coverage; it falls short of 5 only because synonyms like "make"/"build a skill" are absent.	4 / 5
Distinctiveness Conflict Risk	Skill creation is a clear meta-niche with distinct triggers ("create a new skill", "update an existing skill") and minimal overlap with other skills, matching the clear-niche anchor.	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: mixpanel/mixpanel-headless
Path: .claude/skills/skill-creator/SKILL.md
Commit: 1ccd7ae

Reviewed: 3 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.