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

80%

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

The canonical home for this skill is skill-creator in chrisboden/cursor-skills

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 well-structured with a clear multi-step workflow, executable script invocations, validation feedback loops, and properly signaled bundle references. Its main weakness is conceptual exposition in the intro sections that competes with the token budget without adding non-obvious value.

Suggestions

Trim the 'About Skills' and 'Anatomy of a Skill' explanatory prose to only non-obvious guidance, moving generic skill-structure explanation to a references file if needed.

Consider folding the repeated 'When to include' rationale for scripts/references/assets into terser bullet criteria to reduce inline verbosity.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient procedural guidance but the 'About Skills' / 'Anatomy of a Skill' sections spend tokens explaining what skills are and how they are structured—concepts an AI consumer largely already knows—so it does not reach the 'every token earns its place' bar of 3.	2 / 3
Actionability	It gives copy-paste-ready commands ('scripts/init_skill.py <skill-name> --path <output-directory>', 'scripts/package_skill.py <path/to/skill-folder>') and concrete worked examples (pdf-editor, frontend-webapp-builder, big-query) that map directly to bundle scripts, meeting the 'fully executable commands; specific examples' anchor.	3 / 3
Workflow Clarity	The Skill Creation Process is a clearly sequenced Steps 1-6 with an explicit validation checkpoint and error-recovery 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' anchor.	3 / 3
Progressive Disclosure	SKILL.md is an overview that points one level deep to bundled scripts (init_skill.py, package_skill.py, quick_validate.py), all of which exist in scripts/ and are clearly signaled by path, with no nested reference chains.	3 / 3
	Total	11 / 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 is clear, in third person, and explicitly covers both what the skill does and when to trigger it, giving it strong completeness and distinctiveness. It is held back slightly by limited concrete-action enumeration and only a couple of trigger-term variations.

Suggestions

Add 2-3 concrete actions the skill performs (e.g. 'scaffold, validate, and package skills') to lift specificity from 2 to 3.

Broaden trigger phrasings to include natural variants like 'make a skill', 'build a skill', or 'set up a skill'.

Dimension	Reasoning	Score
Specificity	The description names the domain (skill creation) and actions ('create a new skill (or update an existing skill)', 'extends Claude's capabilities with specialized knowledge, workflows, or tool integrations') but does not enumerate multiple concrete capabilities, so it sits at 'names domain and some actions' rather than the comprehensive list of a 3.	2 / 3
Completeness	It states what the skill does ('Guide for creating effective skills') and explicitly when to use it ('This skill should be used when users want to create a new skill (or update an existing skill)'), satisfying the explicit what-and-when-with-trigger bar.	3 / 3
Trigger Term Quality	Natural phrasings like 'create a new skill' and 'update an existing skill' are present, but only two variations of the trigger are offered and common variants (e.g. 'make/build a skill') are missing, matching 'some relevant keywords but missing common variations'.	2 / 3
Distinctiveness Conflict Risk	'Creating effective skills' is a narrow, well-defined niche with distinct triggers unlikely to overlap with other skills, matching the 'clear niche with distinct triggers' anchor.	3 / 3
	Total	10 / 12 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 12 missing	Warning

	Total	15 / 16 Passed

Repository: SynkraAI/aiox-core
Path: .claude/skills/skill-creator/SKILL.md
Commit: 0b32b68

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