CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

80

2.13x
Quality

73%

Does it follow best practices?

Impact

92%

2.13x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./bot/workspace/skills/skill-creator/SKILL.md

The canonical home for this skill is skill-creator in HKUDS/nanobot

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.

The body is a well-structured, largely actionable guide with an exemplary sequenced workflow and embedded validation/iteration loops. Its weaknesses are mild verbosity in the conceptual sections and progressive-disclosure references that point to bundle files not present in this skill directory.

Suggestions

Trim or move to a reference file the conceptual material an agent already knows — the 'About Skills' overview, 'What Skills Provide' list, and the bridge/field metaphor in the degrees-of-freedom section.

Ensure the referenced bundle files (scripts/init_skill.py, scripts/package_skill.py, references/workflows.md, references/output-patterns.md) ship with the skill, since the workflow's steps 3 and 5 depend on them.

Tighten Step 1's question examples into a compact template (e.g., a 2-3 question starter list) instead of the full four-question prose block.

DimensionReasoningScore

Conciseness

The body is mostly lean instructional prose with concrete commands, but it includes unnecessary padding: the 'About Skills' conceptual overview and 'What Skills Provide' list restate knowledge an agent using a skill-creator skill already has, and metaphors like 'a narrow bridge with cliffs needs specific guardrails (low freedom), while an open field allows many routes (high freedom)' add tokens without procedure. This matches the 3 anchor 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 2 because there is no severe padding of basic concepts like what a PDF or library is.

3 / 5

Actionability

Most guidance is directly executable: full invocations for 'scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]' and 'scripts/package_skill.py <path/to/skill-folder> ./dist', concrete naming rules ('lowercase letters, digits, and hyphens only', 'under 64 characters'), and worked analysis examples (pdf-editor, big-query, frontend-webapp-builder). It falls short of a 5 because some sections — notably the degrees-of-freedom discussion and Step 1's question lists — stay at the guidance level rather than giving copy-ready artifacts.

4 / 5

Workflow Clarity

The six-step creation process is explicitly sequenced ('Follow these steps in order, skipping only if there is a clear reason why they are not applicable') with per-step skip conditions, an embedded validation checkpoint (packaging 'automatically validates the skill' and 'will report the errors and exit without creating a package'), an explicit error-recovery feedback loop ('Fix any validation errors and run the packaging command again'), and a testing requirement for added scripts. This matches the 5 anchor 'Clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The 371-line body is well under its own 500-line limit, clearly sectioned, and it signals one-level-deep references with when-to-read guidance ('See references/workflows.md for sequential workflows and conditional logic', 'See references/output-patterns.md for template and example patterns'), and teaches the same pattern. It is not a 5 because the referenced bundle files (scripts/init_skill.py, scripts/package_skill.py, references/workflows.md, references/output-patterns.md) are not present in the skill directory, and some conceptual teaching (the progressive-disclosure pattern gallery) could itself live in a reference file to keep SKILL.md leaner.

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.

The description is well-formed: third-person voice, an explicit 'Use when' clause, and a distinct niche. Its main weakness is that the 'what' side is under-specified — it states only 'create or update' without listing the concrete capabilities the skill actually delivers.

Suggestions

Enumerate the concrete capabilities in the 'what' clause, e.g. 'Create or update AgentSkills: plan reusable contents, initialize the skill directory, write SKILL.md frontmatter and body, and package/validate skills for distribution.'

Add a few more natural trigger phrases users would actually say, such as 'build a skill', 'write a SKILL.md', or 'package a .skill file', to strengthen keyword coverage.

DimensionReasoningScore

Specificity

"Create or update AgentSkills" names the domain and exactly two concrete actions, with no enumeration of the actual capabilities (init script, packaging/validation, naming, frontmatter design) that the skill provides. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — a 4 would require several specific actions with only minor coverage gaps.

3 / 5

Completeness

Both parts are present: a 'what' ("Create or update AgentSkills") and an explicit 'when' ("Use when designing, structuring, or packaging skills..."). It is not a 5 because the 'what' is thin — it never says what creating a skill concretely involves (planning contents, init script, editing, packaging) — matching the anchor 'Has both what and when; when could be more explicit or specific'.

4 / 5

Trigger Term Quality

"designing, structuring, or packaging skills with scripts, references, and assets" gives good natural-keyword coverage that users would plausibly say. A few common variations are missing (e.g., 'build a skill', 'SKILL.md', '.skill file', 'frontmatter'), which keeps it below the comprehensive-synonym coverage of a 5 but above the 3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

"AgentSkills" plus the scripts/references/assets framing carves out a clear niche with distinct trigger terms; 'create or update', 'designing, structuring, or packaging skills' would not naturally fire for unrelated skills (PDF, documents, data). This matches the 5 anchor 'Clear niche with distinct triggers; minimal conflict risk' rather than the 4 anchor's 'minor overlap risk with closely related skills'.

5 / 5

Total

16

/

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: 20 missing

Warning

Total

14

/

16

Passed

Repository
volcengine/OpenViking
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.