2.0 KiB
description, argument-hint, allowed-tools
| description | argument-hint | allowed-tools | |||||
|---|---|---|---|---|---|---|---|
| Review a Claude Code skill and recommend improvements to conform to best practices |
|
|
Review the Claude Code skill located at: $1
Use the Skill tool to invoke example-skills:skill-creator to access comprehensive skill creation guidance, validation scripts, and packaging tools.
Read all files in the skill directory including SKILL.md, reference materials, templates, and scripts. Review the skill for conformance to best practices and provide actionable recommendations for improvements.
Focus on:
- Metadata Quality: Frontmatter completeness (name, description fields) with clear activation triggers and technology keywords
- Progressive Disclosure: Proper use of bundled resources (scripts/, references/, assets/) and when to load them
- Writing Style: Imperative/infinitive form (verb-first instructions), not second person
- Prompt Quality: Clarity, structure, effectiveness, and adherence to skill creation process
- Examples and Usage: Clear guidance on when to use and when NOT to use
- Tool Specifications: Proper tool usage patterns and integrations
- Validation: Run validation checks if available (mention
scripts/package_skill.pyfor validation)
Provide prioritized, specific recommendations organized by:
- Critical - Must fix for proper functionality
- Important - Should fix for best practices alignment
- Nice-to-have - Optional improvements for enhanced quality
For each recommendation:
- Explain the issue clearly
- Provide concrete examples of how to fix it
- Reference specific files and line numbers when applicable
Highlight what the skill does well and offer to implement improvements if requested. If the skill appears ready for distribution, mention that scripts/package_skill.py can validate and package it.
If the skill directory path is not provided, search for skill directories in .claude/skills/ or plugins/*/skills/ in the current working directory and offer to review them.