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 Gemini CLI's capabilities with specialized knowledge, workflows, or tool integrations.
82
56%
Does it follow best practices?
Impact
100%
1.29xAverage score across 6 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./packages/core/src/skills/builtin/skill-creator/SKILL.mdQuality
Discovery
57%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 adequately communicates when to use the skill with an explicit trigger clause, but fails to describe concrete actions the skill performs. The vague 'guide for creating effective skills' doesn't tell Claude what specific outputs or steps are involved. Additionally, the reference to 'Gemini CLI' may be incorrect or confusing in context.
Suggestions
Replace the vague 'Guide for creating effective skills' with specific actions like 'Generates skill markdown files with proper YAML frontmatter, description fields, and structured content sections'.
Add more natural trigger term variations such as 'SKILL.md', 'skill file', 'skill template', 'write a skill', 'define a skill'.
Verify the 'Gemini CLI' reference is correct; if this skill is for Claude, update accordingly to avoid confusion and improve distinctiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'creating effective skills' and 'extends capabilities with specialized knowledge, workflows, or tool integrations' without listing any concrete actions. It doesn't specify what the skill actually does (e.g., generates YAML frontmatter, writes markdown templates, validates skill structure). | 1 / 3 |
Completeness | The description does answer both 'what' (guide for creating effective skills) and 'when' (when users want to create a new skill or update an existing skill). It has an explicit 'Use when' equivalent clause with 'This skill should be used when...'. | 3 / 3 |
Trigger Term Quality | It includes some relevant trigger terms like 'create a new skill', 'update an existing skill', and 'skills', which users might naturally say. However, it references 'Gemini CLI' which seems like a mismatch (possibly wrong product), and it misses variations like 'skill file', 'SKILL.md', 'skill template', or 'write a skill'. | 2 / 3 |
Distinctiveness Conflict Risk | The skill targets a fairly specific niche (skill creation/editing), which helps with distinctiveness. However, the vague phrasing about 'specialized knowledge, workflows, or tool integrations' could overlap with general documentation or configuration skills. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
54%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive meta-skill for creating skills that excels in workflow clarity and progressive disclosure, but suffers significantly from verbosity. It explains many concepts that an AI agent would already understand (what scripts are, what assets are, basic file organization) and includes redundant elaboration throughout. The actionability is moderate—while the init/package steps are concrete, the core creative task of writing effective skill content lacks specific, executable examples of good output.
Suggestions
Cut explanatory prose by ~50%: remove descriptions of what PDFs are, what scripts/references/assets conceptually provide, and other knowledge Claude already has. Focus on the non-obvious constraints and patterns.
Add a concrete before/after example of a well-written SKILL.md body in Step 4, showing exactly what good skill content looks like rather than abstractly describing it.
Consolidate the 'What Skills Provide,' 'About Skills,' and 'Anatomy of a Skill' sections into a single lean reference, moving detailed resource-type descriptions (scripts, references, assets) into a separate reference file to practice the progressive disclosure the skill advocates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ lines, explaining many concepts that Gemini CLI already knows (what PDFs are, what scripts do, what assets are). It includes extensive explanations of basic concepts like 'what skills provide,' lengthy descriptions of file types, and redundant elaboration throughout. Much of this could be cut by 50%+ without losing actionable information. | 1 / 3 |
Actionability | The skill provides concrete commands for init and packaging scripts, and includes specific naming conventions and directory structures. However, the actual SKILL.md writing guidance is largely abstract ('write instructions for using the skill'), and the Step 4 'Edit the Skill' section—the core creative task—lacks concrete examples of good vs bad skill body content. The code examples shown are illustrative directory trees and markdown snippets rather than executable code. | 2 / 3 |
Workflow Clarity | The 7-step creation process is clearly sequenced with explicit ordering ('Follow these steps in order, skipping only if there is a clear reason'), includes validation via the packaging script (Step 5), and has a clear iteration feedback loop (Step 7). Each step has clear entry/exit criteria and the packaging step includes automatic validation with error recovery guidance. | 3 / 3 |
Progressive Disclosure | The skill practices what it preaches—it references external files like references/workflows.md and references/output-patterns.md for detailed patterns, keeps the main SKILL.md as an overview with navigation, and demonstrates multiple progressive disclosure patterns (Pattern 1-3) with clear examples. References are one level deep and well-signaled. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
0758a5e
Table of Contents
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.