skill-creator

Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends agent 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 ./resources/example-skills/skill-creator/SKILL.md

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 a well-structured, actionable guide with clear sequencing, validation checkpoints, and properly signaled one-level references, held back only by a few introductory passages that re-explain familiar concepts.

Suggestions

Trim the 'About Skills' and 'What Skills Provide' sections, which restate what skills are; assume Claude's competence as the skill's own principles advise.

Move or compress the conceptual framing in 'Core Principles' to rely more on the concrete examples that follow.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with concrete commands and tight examples, but sections like 'About Skills' and 'What Skills Provide' explain what skills are (concepts Claude already knows) and could be tightened, matching the anchor-2 'mostly efficient but includes some unnecessary explanation'.	2 / 3
Actionability	Provides copy-paste-ready commands ('python scripts/init_skill.py <skill-name> --path <output-directory>', 'python scripts/package_skill.py <path/to/skill-folder>'), concrete directory trees, and specific file-naming examples, meeting the anchor-3 'fully executable commands; specific examples; copy-paste ready'.	3 / 3
Workflow Clarity	Presents a clear ordered 6-step sequence ('Follow these steps in order') with an explicit validation feedback loop in packaging ('If validation fails... Fix any validation errors and run the packaging command again') and a script-testing checkpoint, matching anchor-3.	3 / 3
Progressive Disclosure	SKILL.md is an overview that explicitly signals one-level-deep references ('See references/workflows.md', 'See references/output-patterns.md') — both verified to exist — alongside real scripts, matching anchor-3 'clear overview with well-signaled one-level-deep references'.	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 cleanly answers both what the skill does and when to use it with an explicit trigger clause and a distinct niche, but its action list and trigger-term coverage are slightly thin compared to top-anchor examples.

Suggestions

Expand the action list with more specific concrete verbs (e.g., 'scaffold, validate, and package skills') to raise specificity.

Add common natural trigger variations such as 'build a skill' or 'make a skill' to broaden trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain ('creating effective skills') and two actions ('creating a new skill', 'updating an existing skill') plus the nature of skills ('specialized knowledge, workflows, or tool integrations'), but does not enumerate a comprehensive list of concrete actions as the anchor-3 example does.	2 / 3
Completeness	Clearly states what it does ('Guide for creating effective skills') and gives an explicit 'Use when' trigger clause, satisfying both 'what' and 'when' per the anchor-3 example.	3 / 3
Trigger Term Quality	Includes natural triggers a user would say ('creating a new skill', 'updating an existing skill') but misses common variations such as 'build a skill' or 'make a skill', matching the anchor-2 'some relevant keywords but missing common variations'.	2 / 3
Distinctiveness Conflict Risk	Occupies a clear niche (skill authoring) with distinct triggers ('creating a new skill or updating an existing skill') unlikely to conflict with other skills, matching the anchor-3 'clear niche with distinct triggers'.	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: eigent-ai/eigent
Path: resources/example-skills/skill-creator/SKILL.md
Commit: 9d0a169

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