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

72%

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 ./.agents/skills/skill-creator/SKILL.md

Quality

Content

70%

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 clear, well-sequenced workflow with validation loops and sound progressive-disclosure structure. It loses points mainly on conciseness (overlapping explanation sections) and actionability (illustrative rather than copy-paste examples).

Suggestions

Consolidate the About Skills, Anatomy of a Skill, and Bundled Resources sections to remove overlapping restatement of what skills/scripts/references/assets are.

Add a concise copy-paste-ready minimal SKILL.md template snippet in Step 4 so the body has at least one fully executable example beyond the CLI commands.

Dimension	Reasoning	Score
Conciseness	The 433-line body is mostly on-topic and explicitly champions token efficiency, but the About/Anatomy/Bundled-Resources sections restate overlapping concepts and could be tightened, matching the score-2 anchor of mostly efficient with some unnecessary explanation.	2 / 3
Actionability	Provides concrete executable commands (init_skill.py, package_skill.py with arguments) and concrete file examples, but much of the guidance is illustrative markdown rather than copy-paste-ready code, fitting the score-2 anchor of concrete but incomplete guidance.	2 / 3
Workflow Clarity	The six-step creation process is explicitly sequenced, includes a script-testing checkpoint, and the packaging step has a validate -> fix -> retry feedback loop, matching the score-3 anchor of clear sequence with explicit validation steps.	3 / 3
Progressive Disclosure	SKILL.md stays an overview and points one level deep to verified bundle files (references/workflows.md, references/output-patterns.md), and explicitly instructs keeping references one level deep, matching the score-3 anchor.	3 / 3
	Total	10 / 12 Passed

Description

75%

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 both what the skill does and when to use it with an explicit trigger clause, and occupies a distinct niche. It would score higher with a broader set of concrete actions and more varied natural-language trigger terms.

Suggestions

Expand the action list with concrete sub-tasks (e.g., scaffolding a skill, writing SKILL.md, packaging/validating) to reach the score-3 specificity anchor.

Add more natural trigger variations users might say, such as 'build a skill', 'make a skill', or 'scaffold a skill'.

Dimension	Reasoning	Score
Specificity	Names the skill-creation domain and several actions ('create a new skill (or update an existing skill)', 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations'), but the actions are somewhat abstract rather than a comprehensive list of concrete operations like the score-3 anchor.	2 / 3
Completeness	Explicitly answers both what ('Guide for creating effective skills... extends Claude's capabilities') and when ('This skill should be used when users want to create a new skill (or update an existing skill)'), with an explicit 'Use when'-style trigger clause, so it is not capped at 2.	3 / 3
Trigger Term Quality	Includes natural triggers a user would say ('when users want to create a new skill', 'update an existing skill'), but coverage is limited and misses common variations such as 'build a skill' or 'make a skill', matching the score-2 anchor.	2 / 3
Distinctiveness Conflict Risk	Skill creation is a distinct meta-task niche with clear, specific triggers unlikely to overlap with domain skills, matching the score-3 anchor.	3 / 3
	Total	10 / 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
relative_links	Relative link issues: 6 missing	Warning
referenced_paths_exist	Referenced path issues: 12 missing	Warning

	Total	14 / 16 Passed

Repository: quran/quran.com-frontend-next
Path: .agents/skills/skill-creator/SKILL.md
Commit: aff1a03

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