skill-reviewer
Review and audit agent skills (SKILL.md files) for quality, correctness, and effectiveness. Use when evaluating a skill before publishing, reviewing someone else's skill, scoring skill quality, identifying defects in skill content, or improving an existing skill.
Why use this skill?
Audit and improve your OpenClaw agent skills with this professional review tool. Ensure structural compliance, optimize metadata, and enhance your skill documentation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/gitgoodordietrying/skill-reviewerWhat This Skill Does
The skill-reviewer is an essential utility for OpenClaw users, developers, and maintainers. It provides a standardized framework for auditing agent skills (SKILL.md files) to ensure they meet the registry's quality standards. By automating the evaluation process, it helps identify structural defects, improves frontmatter discoverability, and ensures that example content is well-balanced and useful for end-users. The skill acts as a linter and quality coach, guiding authors to refine their documentation for better performance and higher searchability within the OpenClaw ecosystem.
Installation
To install this skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/gitgoodordietrying/skill-reviewer
Ensure that you have the latest version of the OpenClaw agent installed before proceeding to ensure full compatibility with the metadata parsing features.
Use Cases
This skill is intended for three primary audiences. First, developers who are building new skills for the OpenClaw registry can use it to self-audit their work before submitting a pull request, ensuring their skills are ready for prime time. Second, community members reviewing third-party skills can use the tool to score the quality of an unknown package, helping them decide if it is trustworthy and well-documented. Finally, current skill authors can use the tool to perform a 'health check' on older documentation, bringing legacy skills up to modern standards by updating keywords, example density, and metadata fields.
Example Prompts
- "Review my current skill in this folder: I want to make sure my description hits the 50-200 character range and uses strong active verbs."
- "Analyze this SKILL.md file for structural defects and check if my metadata emoji and binary requirements are accurately defined."
- "Evaluate the example density of this skill; I think my code blocks might be too infrequent or too long for effective user learning."
Tips & Limitations
When using this skill, focus on the 'Description Scoring' section; it is the most vital for SEO within the OpenClaw registry. If your skill description is too generic, users will not find your work when searching. Remember that the skill-reviewer is an advisor; while it provides a structured score, prioritize clarity and actual utility in your examples over blindly optimizing for the rubric. Be aware that it currently only supports Markdown-based SKILL.md files and cannot validate complex external assets or binary dependency behavior beyond listing defined requirements.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-gitgoodordietrying-skill-reviewer": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read
Related Skills
shell-scripting
Write robust, portable shell scripts. Use when parsing arguments, handling errors properly, writing POSIX-compatible scripts, managing temp files, running commands in parallel, managing background processes, or adding --help to scripts.
api-dev
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
skill-writer
Write high-quality agent skills (SKILL.md files) for ClawdHub/MoltHub. Use when creating a new skill from scratch, structuring skill content, writing effective frontmatter and descriptions, choosing section patterns, or following best practices for agent-consumable technical documentation.
log-analyzer
Parse, search, and analyze application logs across formats. Use when debugging from log files, setting up structured logging, analyzing error patterns, correlating events across services, parsing stack traces, or monitoring log output in real time.
data-validation
Validate data with schemas across languages and formats. Use when defining JSON Schema, using Zod (TypeScript) or Pydantic (Python), validating API request/response shapes, checking CSV/JSON data integrity, or setting up data contracts between services.