CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

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

48

Quality

51%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./nanobot/skills/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 functional and covers both 'what' and 'when' adequately, earning full marks on completeness. However, it lacks specificity in the concrete actions it performs and could include more natural trigger terms that users would actually say. The distinctiveness is moderate—'AgentSkills' is a niche term but the supporting details are generic enough to risk overlap.

Suggestions

Add more specific concrete actions, e.g., 'Create or update AgentSkills by generating YAML frontmatter, writing skill scripts, organizing reference files, and validating skill structure.'

Include more natural trigger term variations such as 'SKILL.md', 'skill file', 'skill template', 'new skill', 'skill definition' to improve matching.

DimensionReasoningScore

Specificity

Names the domain ('AgentSkills') and some actions ('create or update', 'designing, structuring, packaging'), but the actions remain somewhat abstract—it doesn't specify concrete operations like 'write YAML frontmatter', 'generate script files', or 'validate skill structure'.

2 / 3

Completeness

Clearly answers both 'what' (create or update AgentSkills with scripts, references, and assets) and 'when' ('Use when designing, structuring, or packaging skills'), providing explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes relevant terms like 'skills', 'scripts', 'references', 'assets', 'packaging', but misses natural variations users might say such as 'skill file', 'SKILL.md', 'skill template', 'new skill', or 'skill definition'. 'AgentSkills' is a somewhat specialized term that users may or may not use.

2 / 3

Distinctiveness Conflict Risk

The term 'AgentSkills' provides some distinctiveness, but 'scripts, references, and assets' is broad enough to potentially overlap with general file management or project scaffolding skills. The description could be more precise about what makes this skill unique.

2 / 3

Total

9

/

12

Passed

Implementation

35%

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

This meta-skill about creating skills is deeply ironic in that it violates many of its own principles—it's verbose, explains concepts Claude already knows (what PDFs are, what scripts do), and keeps too much detail inline rather than in reference files. The actionable parts (init_skill.py, package_skill.py commands, naming conventions, directory structure) are genuinely useful, but they're buried in extensive explanatory prose that a capable AI agent doesn't need.

Suggestions

Reduce the body by 50-60% by removing explanations of concepts Claude already knows (e.g., 'What Skills Provide', 'About Skills' intro, explanations of what scripts/references/assets are) and moving detailed patterns to reference files as the skill itself recommends.

Move the progressive disclosure patterns, bundled resource guidelines, and design principle examples into a references/design-patterns.md file, keeping only the core 6-step workflow and essential rules in SKILL.md.

Add explicit validation checkpoints between Steps 4 and 5, such as a checklist to verify SKILL.md is under 500 lines, frontmatter description is comprehensive, and all referenced files exist.

Replace abstract guidance like 'Consider what procedural knowledge would help' with a concrete checklist or decision matrix that maps task characteristics to specific skill design choices.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, extensively explaining concepts Claude already knows (what skills are, what scripts/references/assets are, progressive disclosure as a concept). Sections like 'What Skills Provide' and 'About Skills' are unnecessary preamble. Much of the content reads like a tutorial for a human rather than actionable instructions for an AI agent, which is ironic given the skill's own advice about conciseness.

1 / 3

Actionability

The skill provides concrete commands for init_skill.py and package_skill.py with executable examples, and includes specific naming conventions and directory structures. However, much of the guidance is abstract (e.g., 'Consider what procedural knowledge... would help another agent instance') and the SKILL.md writing section gives general principles rather than copy-paste-ready templates or concrete examples of good vs bad body content.

2 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced and each step has defined entry/exit criteria (e.g., 'Conclude this step when there is a clear sense of the functionality'). However, validation is only mentioned as part of the packaging script (Step 5) with no explicit feedback loop for testing the skill's actual effectiveness before packaging. The instruction to test scripts is mentioned but lacks specific validation checkpoints.

2 / 3

Progressive Disclosure

The skill references two external files (references/workflows.md and references/output-patterns.md) with clear descriptions of when to consult them. However, the SKILL.md itself is a monolithic wall of text that violates its own advice about keeping SKILL.md under 500 lines and splitting content. Much of the detailed guidance about progressive disclosure patterns, bundled resources, and design principles could be moved to reference files.

2 / 3

Total

7

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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