CtrlK
BlogDocsLog inGet started
Tessl Logo

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 Gemini CLI's capabilities with specialized knowledge, workflows, or tool integrations.

78

1.29x
Quality

46%

Does it follow best practices?

Impact

100%

1.29x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./packages/core/src/skills/builtin/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 provides clear 'when to use' guidance but lacks specificity about what concrete actions the skill performs. The reference to 'Gemini CLI' appears to be an error that could cause confusion. The vague capability language ('specialized knowledge, workflows, or tool integrations') weakens both specificity and distinctiveness.

Suggestions

Replace vague capability language with concrete actions, e.g., 'Generates skill files with proper YAML frontmatter, markdown instructions, and tool configurations' instead of 'extends capabilities with specialized knowledge, workflows, or tool integrations.'

Add more natural trigger terms users might say, such as 'write a skill,' 'skill template,' 'skill.md file,' 'new capability,' or 'custom instruction.'

Fix the reference to 'Gemini CLI' — if this is a Claude skill, it should reference the correct platform to avoid confusion and misdirected triggers.

DimensionReasoningScore

Specificity

The description uses vague language like 'Guide for creating effective skills' and 'extends capabilities with specialized knowledge, workflows, or tool integrations.' It does not list concrete actions such as 'generates YAML frontmatter,' 'writes markdown instructions,' or 'validates skill structure.'

1 / 3

Completeness

It does answer both 'what' (guide for creating effective skills that extend capabilities) and 'when' (when users want to create a new skill or update an existing skill). The 'Use when' equivalent is explicitly stated with 'This skill should be used when...'

3 / 3

Trigger Term Quality

It includes some relevant keywords like 'create a new skill,' 'update an existing skill,' and 'skill' itself. However, it references 'Gemini CLI' which seems incorrect or confusing for a Claude skill, and it misses natural variations users might say like 'write a skill,' 'skill template,' 'skill.md,' or 'add a new capability.'

2 / 3

Distinctiveness Conflict Risk

The skill targets a fairly specific niche (meta-skill creation), but the vague language about 'specialized knowledge, workflows, or tool integrations' could overlap with general documentation or configuration skills. The mention of 'Gemini CLI' instead of Claude adds confusion about its intended scope.

2 / 3

Total

8

/

12

Passed

Implementation

35%

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, but it suffers significantly from verbosity—it explains many concepts that an LLM already understands and includes extensive rationale that doesn't add actionable value. The workflow is reasonably clear with a 7-step process, but the skill would benefit greatly from practicing the conciseness it preaches. The actionability is moderate: concrete commands exist for tooling but the core writing guidance remains abstract.

Suggestions

Cut the 'About Skills' and 'What Skills Provide' sections entirely—Gemini CLI doesn't need to be told what skills are when it's creating one. Move straight to the creation process.

Reduce the bundled resources section (scripts/references/assets explanations) to a concise table or bullet list, moving detailed guidance to a reference file like references/resource-types.md.

Add a concrete before/after example of a well-written vs poorly-written SKILL.md body to make the writing guidance more actionable rather than relying on abstract principles.

Add explicit validation checkpoints between steps (e.g., 'Before proceeding to Step 5, verify: frontmatter has name and description, no TODO placeholders remain, all referenced files exist').

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, with significant portions explaining concepts that Gemini CLI already knows (what skills are, what PDFs are, what scripts do). Sections like 'What Skills Provide' and 'About Skills' are largely unnecessary. Many bullet points restate obvious information (e.g., explaining what assets are, what references are). The content could be cut by 50%+ without losing actionable value.

1 / 3

Actionability

The skill provides concrete commands for init and packaging scripts, and includes a clear 7-step process. However, the SKILL.md body writing guidance is mostly abstract principles rather than executable templates. The examples shown are illustrative directory structures and markdown snippets rather than copy-paste-ready skill content. The actual 'how to write good instructions' part lacks concrete before/after examples of skill body content.

2 / 3

Workflow Clarity

The 7-step process is clearly sequenced and each step has reasonable detail. However, validation is only mentioned as part of the packaging step (Step 5), and there are no explicit checkpoints between steps like 'verify the skill triggers correctly before proceeding to packaging.' The iteration step (Step 7) mentions testing but lacks specific validation criteria or feedback loops for catching common issues.

2 / 3

Progressive Disclosure

The skill references two external files (references/workflows.md and references/output-patterns.md) with clear descriptions of when to consult them. However, the SKILL.md itself is monolithic and contains extensive inline content that could be split out—the detailed explanations of scripts/references/assets directories, the progressive disclosure patterns section, and the naming conventions could all be reference files. The skill teaches progressive disclosure but doesn't fully practice it.

2 / 3

Total

7

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
google-gemini/gemini-cli
Reviewed

Table of Contents

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.