CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./desktop/builtin-skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable instruction body with an exemplary validated workflow — explicit checkpoints, feedback loops, and forward-testing discipline. Its main costs are redundancy across sections (forward-testing and agents/openai.yaml each covered two to three times) and the absence of any pointer to the bundled assets.

Suggestions

Consolidate forward-testing guidance into the single 'Forward-testing' section and have 'Protect Validation Integrity' and 'Step 4' reference it in one line each, removing roughly 30-40 duplicated lines.

Mention the agents/openai.yaml instructions once (Step 3) and reduce the 'Agents metadata' anatomy subsection to a one-line pointer, since the details are duplicated.

Reference the bundled assets/ files (skill-creator-small.svg, skill-creator.png) from the body — e.g., in the openai.yaml/icon guidance — so every bundle file is discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly efficient and models its own principles, but it carries genuine padding: forward-testing guidance is repeated across 'Protect Validation Integrity', 'Step 4: Edit the Skill', and the 'Forward-testing' section; agents/openai.yaml instructions appear in both 'Anatomy' and 'Step 3'; and phrases like 'The script conveniently generates... making the skill creation process much more efficient and reliable' justify rather than instruct. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened', below the minor-trim level of anchor 4.

3 / 5

Actionability

Guidance is largely copy-paste ready: 'scripts/init_skill.py my-skill --path "${CODEX_HOME:-$HOME/.codex}/skills" --resources scripts,references', 'scripts/quick_validate.py <path/to/skill-folder>', plus concrete example user questions and worked planning examples. It falls short of anchor 5 only in gaps like the forward-testing prompt template lacking a complete example invocation and some steps being described rather than shown.

4 / 5

Workflow Clarity

The six-step creation process is clearly sequenced with skip conditions for each step, an explicit validation checkpoint with a fix-and-retry loop ('If validation fails, fix the reported issues and run the command again'), an iteration workflow, and forward-testing decision rules that include when to ask user approval. This matches the anchor: clear sequence, explicit validation steps, feedback loops, and checklists for complex processes.

5 / 5

Progressive Disclosure

Structure is good: references/openai_yaml.md and all three scripts are real files referenced one level deep with clear signals ('Read references/openai_yaml.md before generating values', 'For full field descriptions and examples, see references/openai_yaml.md'), and the body stays under its own 500-line guidance. It misses anchor 5 due to the cross-section duplication (forward-testing, openai.yaml) and because the assets/ bundle files are never referenced or explained from the body.

4 / 5

Total

16

/

20

Passed

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description with an explicit and well-phrased trigger clause and a distinct niche. Its main weakness is that the 'what' half relies on a generic 'Guide for creating effective skills' formulation instead of enumerating the concrete capabilities (designing, scaffolding, validating, iterating on skills).

Suggestions

Replace 'Guide for creating effective skills' with concrete actions, e.g., 'Design, scaffold, and validate skills: plan reusable contents, generate SKILL.md and bundled scripts/references/assets via init_skill.py, and forward-test with subagents.'

Add common trigger phrasings users would naturally say — e.g., 'Use when the user asks to make, build, or extend a skill' — to broaden natural keyword coverage.

Name the concrete artifacts the skill produces (SKILL.md, scripts/, references/, assets/) so the 'what' is as specific as the 'when'.

DimensionReasoningScore

Specificity

The description names the domain and two concrete actions ('create a new skill (or update an existing skill)'), but 'Guide for creating effective skills' is itself generic — it never states what the guide concretely does (e.g., design, scaffold, validate a skill). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive', not the several-specific-actions anchor above it.

3 / 5

Completeness

Both halves are present: an explicit 'when' ('This skill should be used when users want to create a new skill (or update an existing skill)...') and a 'what' ('Guide for creating effective skills... extends Codex's capabilities with specialized knowledge, workflows, or tool integrations'). It is not a 5 because the 'what' is a single general sentence rather than concrete capability coverage; it is well above 3 because the 'when' is explicit and specific rather than implied.

4 / 5

Trigger Term Quality

'create a new skill' and 'update an existing skill' are natural phrases users would say, giving good keyword coverage, but common variations like 'make a skill', 'build a skill', or 'extend Codex' are missing. Good coverage with a few natural terms missing is exactly the anchor 4 example, short of the synonym-level comprehensiveness of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Skill creation/updating is a clear niche with distinct triggers ('users want to create a new skill'), and it is unlikely to fire for unrelated skills — matching the anchor 'Clear niche with distinct triggers; minimal conflict risk'. The voice is third person throughout, so no specificity penalty applies.

5 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 6 missing

Warning

referenced_paths_exist

Referenced path issues: 12 missing

Warning

Total

13

/

16

Passed

Repository

Jamailar/Beav

Path

desktop/builtin-skills/skill-creator/SKILL.md

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.