Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
65
51%
Does it follow best practices?
Impact
85%
1.21xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/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 structurally sound with an explicit 'Use when...' clause and covers both what and when. However, it lacks specificity in its concrete actions and could benefit from more natural trigger terms that users would actually say. The domain-specific term 'AgentSkills' helps with distinctiveness but the supporting terms are somewhat generic.
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', or 'agent capability'.
| 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 format'. | 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 specific term but may not match how users naturally phrase requests. | 2 / 3 |
Distinctiveness Conflict Risk | The term 'AgentSkills' provides some distinctiveness, but terms like 'scripts', 'references', and 'assets' are generic enough to potentially overlap with other skills related to scripting, file management, or project scaffolding. 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 skill is a comprehensive but overly verbose guide to creating skills. Its main weakness is poor conciseness—it extensively explains concepts Claude already understands (what skills are, what scripts/references/assets do, basic design principles) and includes lengthy examples that could be condensed. The workflow is reasonably clear with a 6-step process and concrete script commands, but the skill would benefit significantly from practicing the very conciseness principles it preaches.
Suggestions
Cut the 'About Skills' and 'What Skills Provide' sections entirely—Claude already knows what skills are. Start directly with the creation process and core principles.
Move the detailed progressive disclosure patterns, directory structure examples, and design principle explanations into a references/ file, keeping only a brief summary and link in SKILL.md.
Add explicit validation checkpoints within Steps 4 (editing) such as 'Verify SKILL.md is under 500 lines' and 'Confirm all referenced files exist' rather than relying solely on the packaging script.
Condense the 'Bundled Resources' section to a brief table (type | when to use | example) instead of the current verbose paragraph format for each resource type.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose, explaining many concepts Claude already knows (what skills are, what PDFs are, what scripts/references/assets mean). It includes extensive explanations of basic concepts like 'progressive disclosure' and 'degrees of freedom' that pad the content significantly. Much of this could be condensed to a fraction of its current length. | 1 / 3 |
Actionability | The skill provides concrete commands for init_skill.py and package_skill.py with usage examples, which is actionable. However, much of the content is conceptual guidance rather than executable steps, and the actual SKILL.md writing instructions are vague ('Write instructions for using the skill and its bundled resources'). The step-by-step process is present but many steps lack specific, copy-paste-ready guidance. | 2 / 3 |
Workflow Clarity | The 6-step creation process is clearly sequenced and provides a reasonable workflow. However, validation checkpoints are mostly delegated to the packaging script at the end rather than being integrated throughout. There's no explicit feedback loop for testing SKILL.md content quality or verifying that scripts work correctly beyond a brief mention of testing 'a representative sample.' | 2 / 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 includes extensive inline content about design patterns, directory structures, and examples that could be split into reference files. The skill teaches progressive disclosure but doesn't practice it well itself. | 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
af8bd5f
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.