Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
65
57%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./nanobot/skills/skill-creator/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
04a41e3
Table of Contents
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.