Create or update AgentSkills, especially when a user wants the agent to learn a reusable capability, workflow, integration, domain rule, team process, or tool usage pattern for future tasks. Use when designing, structuring, reviewing, validating, packaging, or improving skills with SKILL.md, scripts, references, and assets.
71
63%
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 ./openclaw/skills/skill-creator/SKILL.mdQuality
Discovery
92%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted description that clearly communicates both what the skill does and when to use it. It includes a strong 'Use when' clause with explicit triggers and lists concrete artifacts. The main weakness is that some trigger terms like 'workflow' and 'integration' are broad enough to potentially conflict with other domain-specific skills, though the meta-nature of the skill (creating skills) provides some natural distinctiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create or update AgentSkills', 'designing, structuring, reviewing, validating, packaging, or improving skills'. Also specifies concrete artifacts: 'SKILL.md, scripts, references, and assets'. | 3 / 3 |
Completeness | Clearly answers both 'what' (create or update AgentSkills with SKILL.md, scripts, references, and assets) and 'when' (explicit 'Use when' clause covering designing, structuring, reviewing, validating, packaging, or improving skills). Both halves are well-articulated. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'learn a reusable capability', 'workflow', 'integration', 'domain rule', 'team process', 'tool usage pattern', 'skills', 'SKILL.md'. These cover a wide range of how users might phrase requests about teaching the agent new skills. | 3 / 3 |
Distinctiveness Conflict Risk | While 'AgentSkills' and 'SKILL.md' are fairly distinctive terms, the broad scope of 'workflow, integration, domain rule, team process, tool usage pattern' could overlap with skills focused on those specific domains. The description is meta (a skill about creating skills), which helps distinctiveness, but the breadth of trigger terms like 'workflow' and 'integration' could cause false positives. | 2 / 3 |
Total | 11 / 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 comprehensive in coverage but severely undermined by its verbosity—it violates its own 'Concise is Key' principle. It contains substantial amounts of explanatory content that Claude already knows (what skills are, what scripts/references/assets do, general software engineering concepts). The actionable parts (init_skill.py usage, package_skill.py usage, the 6-step process) are solid but buried in excessive context that competes for the token budget it explicitly warns about protecting.
Suggestions
Cut the 'About Skills' and 'What Skills Provide' sections entirely—Claude already knows what skills are; jump straight to the creation process and principles.
Move the detailed 'Progressive Disclosure Design Principle' section and 'Anatomy of a Skill' section into a references/ file, keeping only a brief summary and link in SKILL.md.
Collapse the verbose scripts/references/assets explanations into a concise table or bullet list (type | when to use | example) instead of full subsections with bullets for each.
Add explicit validation checkpoints to the workflow: after Step 4 (editing), include a concrete checklist or validation command to verify SKILL.md quality before proceeding to packaging.
| 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). Extensive sections like 'What Skills Provide', 'About Skills', and detailed explanations of file types (scripts, references, assets) with bullet-pointed benefits are unnecessary token expenditure. Much of this reads like user-facing documentation rather than actionable agent instructions. | 1 / 3 |
Actionability | The skill provides concrete executable commands for init_skill.py and package_skill.py with clear usage examples, and the 6-step creation process is specific. However, the actual SKILL.md writing guidance is largely abstract ('Write instructions for using the skill'), and many sections describe concepts rather than providing executable patterns. The examples in the planning section are helpful but are illustrative rather than copy-paste ready. | 2 / 3 |
Workflow Clarity | The 6-step creation process provides a clear sequence, and the packaging step includes validation. However, validation/feedback loops are mostly implicit—Step 4 mentions testing scripts but doesn't provide explicit validation checkpoints or error recovery paths for the overall skill creation workflow. The 'iterate' step is vague ('Notice struggles or inefficiencies') without concrete verification criteria. | 2 / 3 |
Progressive Disclosure | The skill references external files (references/workflows.md, references/output-patterns.md) and describes progressive disclosure as a design principle with good examples. However, the SKILL.md itself is a monolithic wall of text that violates its own advice—much of the detailed content about anatomy, progressive disclosure patterns, and planning examples could be split into reference files. The skill exceeds its own recommended 500-line limit guidance. | 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.
09cce3e
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.