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.
Install with Tessl CLI
npx tessl i github:google-gemini/gemini-cli --skill skill-creator82
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillAgent success when using this skill
Validation for skill structure
Skill initialization and naming conventions
init_skill.cjs used
100%
100%
Hyphen-case skill name
100%
100%
Frontmatter fields only
100%
100%
Single-line description
100%
100%
No auxiliary docs
100%
100%
Template examples deleted
40%
100%
Script test documented
100%
100%
Skill packaged
100%
100%
Imperative form used
75%
100%
Description includes triggers
100%
100%
Progressive disclosure and content organization
SKILL.md under 500 lines
100%
100%
Provider reference files
50%
100%
References one level deep
0%
100%
No content duplication
100%
100%
SKILL.md references provider files
100%
100%
Table of contents in long refs
100%
100%
No auxiliary docs
100%
100%
Description not in body
0%
100%
Imperative form in body
75%
100%
Frontmatter fields only
100%
100%
Skill packaging, scripts output, and deployment
No raw buffer stdout
100%
100%
Clean success message
100%
100%
Error suppression
100%
100%
package_skill.cjs used
100%
100%
Skill file produced
100%
100%
Both install scopes documented
0%
100%
/skills reload instruction
0%
100%
No /skills reload automation
100%
100%
Verify installation step
50%
100%
gemini skills install command
0%
100%
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.