CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

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

65

Quality

57%

Does it follow best practices?

Impact

Pending

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 competent with a clear 'Use when' clause and reasonable domain identification. However, it lacks specific concrete actions (e.g., generating frontmatter, validating skill structure) and could benefit from more natural trigger terms that users would actually say. The distinctiveness is moderate—'AgentSkills' helps but the surrounding language is generic enough to risk overlap.

Suggestions

Add more specific concrete actions like 'generate YAML frontmatter, write skill scripts, organize asset directories' to improve specificity.

Include additional natural trigger terms users might say, such as 'SKILL.md', 'skill file', 'skill template', 'new skill', or 'skill definition'.

DimensionReasoningScore

Specificity

Names the domain ('AgentSkills') and some actions ('create or update', 'designing, structuring, packaging'), but the actions are somewhat generic and don't list concrete specific 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). The 'Use when...' clause is explicitly present with trigger guidance.

3 / 3

Trigger Term Quality

Includes some 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 naturally.

2 / 3

Distinctiveness Conflict Risk

The term 'AgentSkills' provides some distinctiveness, but 'designing, structuring, or packaging' with 'scripts, references, and assets' is broad enough that it could overlap with general project scaffolding or template-creation skills. The niche is somewhat clear but not sharply delineated.

2 / 3

Total

9

/

12

Passed

Implementation

47%

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

This is a comprehensive meta-skill for creating skills, with a well-structured 6-step workflow and good concrete examples of directory structures and commands. However, it significantly violates its own core principle of conciseness—it's verbose, explains concepts Claude already understands (what scripts are, what assets are), and includes large sections of conceptual explanation that could be moved to reference files. The irony of a skill-creation skill that doesn't follow its own progressive disclosure advice weakens its effectiveness.

Suggestions

Move the detailed 'Core Principles', 'Anatomy of a Skill', and 'Progressive Disclosure Design Principle' sections into a references/skill-design-guide.md file, keeping only a brief summary and link in SKILL.md—this would practice what the skill preaches about progressive disclosure and conciseness.

Cut explanatory preamble like 'What Skills Provide' and 'About Skills' entirely—Claude already understands these concepts, and the skill's own principles say to challenge each piece with 'Does the agent really need this explanation?'

Expand Step 4's body-writing section with a concrete template or checklist for writing SKILL.md body content, rather than the current one-liner 'Write instructions for using the skill and its bundled resources.'

Add a concrete example of a complete, minimal SKILL.md (frontmatter + body) as a reference template that Claude can adapt, rather than only showing fragments across different sections.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, explaining many concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets mean conceptually). Extensive sections like 'What Skills Provide' and 'About Skills' are unnecessary preamble. The 'What to Not Include' section lists obvious items. Much of this could be cut by 50%+ without losing actionable content.

1 / 3

Actionability

The skill provides concrete commands for init_skill.py and package_skill.py with executable examples, and gives specific directory structures. However, the SKILL.md writing guidance itself is more descriptive than prescriptive—it tells Claude about principles rather than giving copy-paste templates or checklists for actually writing skill content. The body-writing section ('Write instructions for using the skill') is notably thin.

2 / 3

Workflow Clarity

The 6-step creation process is clearly sequenced with explicit steps, skip conditions, and validation built into the packaging step. Each step has clear entry/exit criteria (e.g., 'Conclude this step when there is a clear sense of the functionality'). The packaging step includes automatic validation with error recovery guidance.

3 / 3

Progressive Disclosure

The skill references external files (references/workflows.md, references/output-patterns.md) which is good progressive disclosure. However, the SKILL.md itself is a monolithic wall of text that could benefit from splitting—the extensive 'Core Principles' and 'Anatomy of a Skill' sections contain detailed reference material that would be better in separate files, keeping SKILL.md leaner per its own advice.

2 / 3

Total

8

/

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.