CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Interactive guide for creating, reviewing, and improving agent skills (SKILL.md folders). Use when the user wants to build a new skill ('create a skill', 'make a skill for X', 'write a SKILL.md', 'turn this workflow into a skill'), review or improve an existing skill, fix a skill that never triggers or triggers too often, or validate a skill folder before sharing it. Do NOT use for general prompt writing, MCP server development, or editing arbitrary markdown files.

76

Quality

96%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 body that practices what it preaches: hard rules stated up front, exact commands with expected output, validation and feedback loops in both workflows, and detail correctly offloaded to real, one-level-deep reference files. The only weakness is mild — an introductory definition and folder-tree explanation that an already-capable agent could partly infer.

Suggestions

Trim the opening paragraph defining what a skill folder is and compress the folder-tree/progressive-disclosure explanation to two or three lines, trusting the reader's familiarity with the concept.

The Step 1 category list (document/asset creation, workflow automation, MCP enhancement) could move to references/patterns.md alongside the other structural patterns, shortening the body's decision overhead.

DimensionReasoningScore

Conciseness

The body is dense with earned tokens — rules, hard requirements, weak/strong examples, and a checklist — and pushes detail (frontmatter fields, patterns, testing templates) into references/. However, minor instances could be trimmed: the opening definition of what a skill folder is ('A skill is a folder that teaches an agent how to handle a specific task or workflow') and the folder-tree explanation of progressive disclosure cover ground an agent in this harness can largely infer. Not a 3 ('several unnecessary explanations') — the padding is at most one or two sentences; not quite a 5 ('every token earns its place').

4 / 5

Actionability

Guidance is fully executable: the exact validator command 'python scripts/validate_skill.py /path/to/your-skill-name' with expected output ('PASS with 0 errors'), a concrete frontmatter template, a concrete weak-vs-strong description example, a literal debugging prompt to ask the agent, data dependencies between steps, and a pre-delivery checklist. This is copy-paste-ready and covers the common cases, matching the anchor-5 standard.

5 / 5

Workflow Clarity

Both workflows are clearly sequenced with numbered steps and explicit validation checkpoints: Step 5 runs the validator with expected output, the review workflow starts by running the validator and maps failure modes to fixes, and Step 6 defines a feedback loop (iterate on a single challenging task until it succeeds, then extract the winning approach). A Quick Checklist backstops the whole process. Not a 4: there are no missing checkpoints.

5 / 5

Progressive Disclosure

Verified against the actual bundle: all referenced files exist (references/frontmatter.md, references/patterns.md, references/testing.md, scripts/validate_skill.py), references are one level deep and clearly signaled ('For all optional fields... read references/frontmatter.md'), and detail is appropriately split out while the body stays an overview. This matches the anchor-5 pattern of a concise overview with well-signaled, one-level-deep pointers.

5 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: concrete WHAT plus an explicit, multi-phrase WHEN with quoted trigger terms, and hard negative triggers that fence off adjacent domains. It stays under length limits, uses third person, and covers every workflow the body implements.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'creating, reviewing, and improving agent skills (SKILL.md folders)', 'fix a skill that never triggers or triggers too often', 'validate a skill folder before sharing it' — which comprehensively cover the skill's capabilities. Not a level below (4 allows 'minor gaps in coverage'), and there are none: every workflow in the body (create, review, validate) is surfaced.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Interactive guide for creating, reviewing, and improving agent skills') and the 'when' ('Use when the user wants to build a new skill... review or improve an existing skill... validate a skill folder before sharing it'), with concrete trigger phrases throughout. This matches the anchor-5 example's structure exactly and exceeds level 4 (where the 'when' could be more explicit).

5 / 5

Trigger Term Quality

It includes literal user phrasings in quotes — 'create a skill', 'make a skill for X', 'write a SKILL.md', 'turn this workflow into a skill' — plus the natural variations 'review or improve an existing skill' and 'validate a skill folder', matching the comprehensiveness of the anchor-5 example (natural terms, synonyms, and file-type keywords like 'SKILL.md folders'). A 4 would require 'a few natural terms missing', which is not the case.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (agent-creation tooling, not general authoring) and negative triggers are explicit: 'Do NOT use for general prompt writing, MCP server development, or editing arbitrary markdown files.' This excludes the most likely collision domains, giving minimal conflict risk; level 4 ('minor overlap risk with closely related skills') is surpassed by the explicit boundary.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
XiaomiMiMo/MiMo-Code
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.