skill-creator

Guide for creating effective skills. Use when creating a new skill (or updating an existing skill) that extends an agent’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 ./packages/builtin-skills/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 a clear sequenced workflow, validation feedback loops, and properly signaled one-level-deep references. Its only real weakness is mild verbosity and some redundant conceptual explanation.

Dimension	Reasoning	Score
Conciseness	The bulk is useful procedural guidance, but it opens with redundant framing ('This skill provides guidance for creating effective skills.') and explains concepts an agent already knows ('Skills are modular, self-contained packages...'), so it could be tightened.	2 / 3
Actionability	It provides concrete executable commands (e.g., 'scripts/init_skill.py <skill-name> --path <output-directory>', 'scripts/package_skill.py <path/to/skill-folder>') plus specific worked examples (rotate_pdf.py, bigquery schema.md), which are copy-paste ready.	3 / 3
Workflow Clarity	It lays out a clear 6-step sequence (understand, plan, init, edit, package, iterate) with an explicit validation feedback loop in packaging ('If validation fails... Fix any validation errors and run the packaging command again') and a test checkpoint for added scripts.	3 / 3
Progressive Disclosure	It is a well-organized overview (~355 lines) with clearly signaled one-level-deep references to real bundle files ('See references/workflows.md', 'See references/output-patterns.md') and script invocations, matching the score-3 anchor.	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 clearly answers both what it does and when to use it with an explicit 'Use when...' trigger and a distinct niche. It is somewhat held back by abstract capability phrasing and limited trigger-term coverage.

Suggestions

Replace the abstract 'specialized knowledge, workflows, or tool integrations' with a few concrete actions the skill helps perform (e.g., 'scaffold, write, validate, and package a skill').

Broaden natural trigger terms to capture common phrasings users actually say, such as 'build a skill', 'make a skill', or 'add a skill for X'.

Dimension	Reasoning	Score
Specificity	It names the domain ('creating effective skills') and some actions ('creating a new skill (or updating an existing skill)'), but the rest are abstract categories ('specialized knowledge, workflows, or tool integrations') rather than a list of multiple concrete actions.	2 / 3
Completeness	It explicitly answers what ('Guide for creating effective skills') and when via an explicit 'Use when creating a new skill (or updating an existing skill)...' trigger clause, matching the score-3 anchor.	3 / 3
Trigger Term Quality	It includes relevant natural phrases like 'creating a new skill' and 'updating an existing skill', but coverage is narrow and misses common variations such as 'build a skill', 'make a skill', or 'skill for X'.	2 / 3
Distinctiveness Conflict Risk	It occupies a clear meta-niche (skill creation/updating) with distinct triggers, making it unlikely to fire for unrelated, non-meta skills.	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: shareAI-lab/Kode-CLI
Path: packages/builtin-skills/skills/skill-creator/SKILL.md
Commit: 4afba64

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.