CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Create, update, or package agent skills.

Quality

65%

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 ./nanobot/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers a well-sequenced, actionable skill-creation workflow with real, verified scripts and an explicit validation feedback loop for packaging. Its main weaknesses are moderate redundancy of the token-efficiency message, two dangling references to nonexistent reference files, and an unreferenced bundled script. Fixing the bundle pointers would lift both actionability and progressive disclosure.

Suggestions

Either add the referenced references/workflows.md and references/output-patterns.md files to the bundle, or remove the "Consult these helpful guides" section — currently both pointers lead nowhere.

Reference scripts/quick_validate.py in the body (e.g., as a pre-packaging validation step) or remove it from the bundle so every bundled file is discoverable from SKILL.md.

Consolidate the repeated keep-it-lean guidance ("Concise is Key", "Avoid duplication", progressive-disclosure patterns) into one section and trim the bridge/open-field metaphor to reduce token cost.

DimensionReasoningScore

Conciseness

The body is mostly efficient with actionable examples, but includes unnecessary padding: the "narrow bridge with cliffs" / "open field" metaphor, the "onboarding guides" analogy, and the keep-it-lean principle repeated across at least four sections ("Concise is Key", "Avoid duplication", "Keeps SKILL.md lean", "Keep SKILL.md body to the essentials"). This matches anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") — above anchor 2 since there is no tutorial-style explanation of concepts the agent already knows.

3 / 5

Actionability

Concrete, executable commands are present and match real bundle files ("scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets]" and "scripts/package_skill.py <path/to/skill-folder]"), plus a worked example description for a docx skill. It falls short of anchor 5 because two pointed-to guides (references/workflows.md, references/output-patterns.md) do not exist in the bundle, leaving "Consult these helpful guides" unactionable.

4 / 5

Workflow Clarity

The six-step creation process is clearly sequenced with explicit skip conditions ("Follow these steps in order, skipping only if there is a clear reason"), script-testing is mandated, and packaging has an explicit feedback loop ("If validation fails, the script will report the errors and exit without creating a package. Fix any validation errors and run the packaging command again"). It misses anchor 5 because there are no checklists and the iterate step is thin — no validation checkpoint for whether an edit actually improved the skill.

4 / 5

Progressive Disclosure

Section structure and heading navigation are good, but scored against the actual bundle: the body directs readers to "references/workflows.md" and "references/output-patterns.md", which do not exist (no references/ directory), and scripts/quick_validate.py is present but never referenced. Broken resource pointers and an orphaned script mean navigation fails when followed, matching anchor 3 ("some structure but could be better organized") rather than anchor 4 ("references mostly clear; minor organization gaps") — dangling files are more than a minor gap.

3 / 5

Total

14

/

20

Passed

Description

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

The description is concise and names a distinct niche, but it omits any "when to use" trigger guidance, which caps its completeness and leaves triggering to inference. It also stays at a high level of abstraction — three generic verbs with no concrete detail about what skill creation involves. A "Use when..." clause with natural trigger phrases would substantially improve it.

Suggestions

Add an explicit trigger clause, e.g., "Use when creating a new skill, editing or updating an existing SKILL.md, packaging a skill for distribution, or when the user mentions skills, skill bundles, or .skill files."

Make the actions more concrete: mention writing SKILL.md frontmatter (name/description), assembling scripts/references/assets, and producing a distributable .skill file rather than only "create, update, or package".

Include natural keyword variations users would actually say ("build a skill", "make a skill", "SKILL.md", "skill template") to improve trigger matching.

DimensionReasoningScore

Specificity

"Create, update, or package agent skills" names the domain (agent skills) and three operations, but the verbs are high-level with no concrete detail of what creation involves (e.g., writing SKILL.md, frontmatter, bundled resources). It matches anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") more than anchor 2 because three distinct operations are listed, but none reach the concreteness of anchor 4 examples like "fills forms, converts pages to images".

3 / 5

Completeness

The "what" is clear ("Create, update, or package agent skills") but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, capping completeness at 3 per the judging guidelines. This exactly matches the anchor 3 example pattern (a clear what with no when), and cannot reach anchor 4 which requires both.

3 / 5

Trigger Term Quality

Core natural terms users would say are present ("create", "update", "package", "skills"), but common variations are missing — "build/make a skill", "SKILL.md", "new skill", "bundle a skill". This matches anchor 3 ("some relevant keywords but missing common variations or synonyms"), below anchor 4 which expects fuller coverage of natural phrasings.

3 / 5

Distinctiveness Conflict Risk

"agent skills" is a clear niche with fairly distinct triggers — skill authoring/package conflicts only with closely related skill-creation skills. It sits at anchor 4 ("mostly distinct; minor overlap risk") rather than 5 because without explicit trigger guidance, broad terms like "update" could occasionally overlap with general file-editing skills.

4 / 5

Total

13

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 missing

Warning

referenced_paths_exist

Referenced path issues: 14 missing

Warning

Total

14

/

16

Passed

Repository

HKUDS/nanobot

Path

nanobot/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.