A technical linter and quality assurance tool designed to scan, score, and optimize your AI agent skill library.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install unblocklabs-skill-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install unblocklabs-skill-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Skill-Audit?
Skill-Audit is a specialized utility designed to maintain the hygiene and performance of your AI agent ecosystem. By scanning global, workspace, and project directories, it ensures that every skill adheres to high-signal documentation standards, such as trigger-oriented descriptions and the inclusion of critical Gotchas sections. This tool is essential for developers who want to scale their Openclaw Skills while avoiding technical debt and redundant functionality.
The skill goes beyond simple file checking by implementing a sophisticated scoring system based on progressive disclosure and structural quality. It identifies orphan files, detects duplicate logic across different scopes, and provides a clear map of category coverage, ensuring your agent always has the right tools for the right task without the bloat of stale or poorly documented skills.
Skill-Audit Use Cases
- Reviewing a local library of Openclaw Skills for structural issues and best-practice compliance.
- Identifying duplicate or overlapping skill functionality across project and global directories.
- Validating that documentation contains high-signal sections like Pitfalls or Common Issues to improve agent reliability.
- Mapping category gaps to identify which areas of automation (e.g., CI/CD, Infrastructure) lack supporting skills.
How Skill-Audit Works
- The user triggers the audit by requesting a skill check or running the audit command.
- The agent executes the
scripts/audit.shutility to crawl all registered skill locations. - Metadata is collected from YAML frontmatter and file structures to evaluate scoring criteria.
- Each skill is scored on a scale of 0-10 based on description quality, directory structure, and specific documentation sections.
- A comprehensive Markdown report is generated in the
.sub-agent-results/directory, detailing findings and prioritized fixes.
Skill-Audit Setup
To initialize the auditing environment for your Openclaw Skills, ensure the script is executable and trigger the audit via the agent interface:
# Ensure the audit script has execution permissions
chmod +x scripts/audit.sh
# Trigger the audit within your agent chat
"audit my skills"
Skill-Audit Data Schema & Taxonomy
The skill organizes audit data into a structured report with the following taxonomy:
| Data Point | Description |
|---|---|
| YAML Frontmatter | Extracts name, description, and compatibility tags. |
| Scorecard | Numeric evaluation (0-10) based on structural benchmarks. |
| Category Map | Classification into one of 9 industry-standard skill categories. |
| Result Path | Reports are saved to .sub-agent-results/skill-audit-report.md. |
Skill-Audit Advanced Features
- Progressive Disclosure Analysis: Checks for subdirectories like
scripts/,references/, andassets/to ensure complex skills are organized effectively. - Trigger-Oriented Linting: Analyzes the
descriptionfield to verify it explicitly tells the model when to activate the skill. - Cross-Scope Deduplication: Detects functional overlaps between global, workspace, and project-specific skill directories.
- Automated Scorecarding: Provides an instant impact-sorted list of issues to fix, categorized by severity (Good, Needs Work, Poor).
SKILL.md
Loading
Related Openclaw Skills
Prototype Factory
A high-fidelity production engine for creating polished, demo-ready interactive prototypes and MVPs across Flutter, React, and SwiftUI.
HTML PPT Generator
An AI-powered tool that transforms presentation themes and reference materials into interactive, high-quality Reveal.js HTML slide decks.
Gymlog
A local developer reference tool providing instant, offline access to best practices, patterns, and implementation guides.
Aloudata Metric Query API
A powerful tool for AI agents to search, construct, and execute multi-dimensional metric queries via a semantic layer.
hair-cam-anno
A professional tool designed for annotating security camera footage to create high-quality Vision-Language (VL) model fine-tuning datasets.
timehe
A digital time capsule platform that enables users to write messages and record memories for loved ones to be unlocked on a specific future date.
Featured*
