CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-creator

Create, update, or package agent skills.

56

Quality

70%

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

70%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 highly actionable, well-sequenced skill-creation workflow with explicit validation and error-recovery checkpoints, but it is longer than its own conciseness advice warrants and references two files missing from the bundle, which undercuts its otherwise good progressive-disclosure structure.

Suggestions

Fix the bundle mismatch: either add references/workflows.md and references/output-patterns.md or remove the pointers in the 'Learn Proven Design Patterns' section so navigation never dead-ends.

Consolidate the duplicated progressive-disclosure guidance (the three-level system explanation vs. the Patterns subsections) and trim conceptual filler like the narrow-bridge/open-field analogy and the repeated keep-lean bullets.

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

DimensionReasoningScore

Conciseness

The ~370-line body is mostly efficient but repeats its progressive-disclosure guidance in both the 'Progressive Disclosure Design Principle' section and the 'Patterns' subsections, restates keep-SKILL.md-lean advice across multiple bullets, and includes conceptual padding such as the narrow-bridge/open-field analogy. It could be tightened without losing clarity, matching the 'mostly efficient but some unnecessary explanation' anchor.

3 / 5

Actionability

Concrete, ready-to-run commands with flags and usage examples ('scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]', 'scripts/package_skill.py <path/to/skill-folder> ./dist') plus sample user questions, worked planning examples (pdf-editor, frontend-webapp-builder, big-query), and a model description. Minor gaps: no interpreter invocation shown, and scripts/quick_validate.py is never documented in the body.

4 / 5

Workflow Clarity

The six-step creation process is clearly sequenced with explicit per-step skip conditions ('Skip this step only when...'), validation is built in (the packaging script 'automatically validates the skill first'), and an explicit feedback loop is given ('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'), with added scripts required to be tested by running them. This matches the clear-sequence-with-explicit-validation-and-recovery anchor.

5 / 5

Progressive Disclosure

The body is well-sectioned and its split-by-domain/variant guidance is sound, but it directs the agent to 'references/workflows.md' and 'references/output-patterns.md', which do not exist in the actual bundle (only scripts/ is present), while the bundled scripts/quick_validate.py is never referenced. Scored against the actual bundle structure, broken navigation and unreferenced files are more than the 'minor organization gaps' of anchor 4, but the body's own structure and one-level-deep reference discipline keep it above anchor 2.

3 / 5

Total

15

/

20

Passed

Description

58%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 states a clear, specific 'what' for a distinct niche but entirely omits 'when to use' guidance and natural trigger keywords, leaving completeness and trigger quality capped at mid-scale. It is concise and non-inflated, just under-specified for triggering.

Suggestions

Add an explicit 'Use when...' clause naming natural triggers, e.g. 'Use when the user asks to create, build, or update a skill, edit a SKILL.md, or package a skill for distribution.'

Include natural synonyms and artifacts users would actually mention: 'SKILL.md', '.skill file', 'skill bundle', 'new skill'.

Optionally enumerate the covered lifecycle (plan, create, edit, validate, package, iterate) to make the 'what' comprehensive.

DimensionReasoningScore

Specificity

'Create, update, or package agent skills' names the domain plus three concrete actions, matching the several-specific-actions-with-minor-gaps anchor. Not 5 because it omits lifecycle steps the body actually covers (plan, validate, iterate), and not 3 since three concrete verbs exceed the 1-2 action anchor.

4 / 5

Completeness

The 'what' is clearly stated (create, update, or package agent skills) but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

'agent skills' plus create/update/package are relevant keywords a user might say, but common natural variations are missing ('build a skill', 'new skill', 'SKILL.md', '.skill file'), matching the some-relevant-keywords-but-missing-variations anchor. Not 4 because coverage is thin, not merely a few terms short.

3 / 5

Distinctiveness Conflict Risk

The agent-skills meta-domain is a mostly distinct niche with only minor overlap risk against adjacent authoring/packaging skills, matching the mostly-distinct anchor. Not 5 because the generic verbs and absence of trigger phrases leave slight ambiguity versus other creator-type skills.

4 / 5

Total

14

/

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.