skill-issue
This skill audits all installed AI agent skills, providing a comprehensive health report that includes inventory, usage tracking, version checks, dependency health, and actionable recommendations.
About this skill
The `skill-issue` agent skill acts as a comprehensive auditor for your entire AI agent skill ecosystem. It systematically scans designated directories to identify every installed skill, tracking its usage by analyzing recent memory or log files. Beyond a simple inventory, it performs critical health checks, verifying required binaries and environment variables, and, if available, checks for skill version updates against a registry like ClawdHub. The core value of `skill-issue` lies in its actionable recommendations, categorizing skills as 'keep' (active and healthy), 'update' (outdated), 'review' (unused or underutilized), or 'remove' (due to broken dependencies or irrelevance). This proactive approach helps maintain a clean, efficient, and secure set of tools for the AI agent. Designed with safety in mind, `skill-issue` operates in a strictly read-only mode, meaning it never modifies, installs, or removes any files or skills from your system. Its output is purely advisory, presenting a detailed markdown report that empowers the agent or its human operator to make informed decisions about skill management, ensuring the agent's environment remains optimized and free from "skill issues."
Best use case
The primary use case for `skill-issue` is maintaining the health and efficiency of an AI agent's skill ecosystem. It's invaluable for agents or human operators who need to regularly review their installed capabilities, identify outdated or unused skills, troubleshoot dependency issues, or ensure all tools are up-to-date. By providing a clear, actionable report, it helps prevent skill bloat, security vulnerabilities from outdated components, and ensures the agent always has access to functional and relevant tools.
This skill audits all installed AI agent skills, providing a comprehensive health report that includes inventory, usage tracking, version checks, dependency health, and actionable recommendations.
A detailed markdown report presenting an inventory of all installed agent skills, their usage tracking, health status, version checks, and actionable recommendations for management.
Practical example
Example input
Agent, please perform a comprehensive audit of all my installed skills and provide a detailed health report.
Example output
Generated a markdown report `/tmp/skill-audit-report.md` detailing skill inventory, usage (e.g., 'my-coding-skill' used 10 times in 7 days), health status (e.g., 'api-tool' missing 'jq' binary), version checks (e.g., 'data-parser' is outdated), and recommendations (e.g., 'update data-parser', 'review unused-tool').
When to use this skill
- When asked to review or audit the current set of installed agent skills.
- To proactively check for skill updates or identify outdated skill versions.
- To find and manage unused skills that might be cluttering the agent's environment.
- To diagnose dependency issues or verify the health of required binaries for skills.
When not to use this skill
- When the goal is to install new skills or directly modify existing skill configurations.
- When deep debugging of a specific skill's internal code or logic is required.
- When you are looking for new skill recommendations or functionalities, rather than auditing existing ones.
How skill-issue Compares
| Feature / Agent | skill-issue | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | medium | N/A |
Frequently Asked Questions
What does this skill do?
This skill audits all installed AI agent skills, providing a comprehensive health report that includes inventory, usage tracking, version checks, dependency health, and actionable recommendations.
How difficult is it to install?
The installation complexity is rated as medium. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
AI Agents for Freelancers
Browse AI agent skills for freelancers handling client research, proposals, outreach, delivery systems, documentation, and repeatable admin work.
SKILL.md Source
# Skill Issue — Skill Auditor Audit all installed skills and produce a markdown report with recommendations. ## Quick Start ```bash # Basic — scans ./skills and ./memory node scripts/audit.mjs # Custom directories SKILL_DIRS="./skills,/path/to/more/skills" MEMORY_DIR="./memory" node scripts/audit.mjs # Save report node scripts/audit.mjs > /tmp/skill-audit-report.md ``` ## Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `SKILL_DIRS` | `./skills` | Comma-separated skill directories to scan | | `MEMORY_DIR` | `./memory` | Dated markdown logs for usage tracking | | `AUDIT_DAYS` | `7` | Days back to scan for usage | ## What It Checks 1. **Inventory** — Finds every subdirectory containing a `SKILL.md` with YAML frontmatter 2. **Usage** — Scans recent memory/log files for skill name mentions 3. **Health** — Verifies required binaries (`requires.bins`) and env vars (`requires.env`) 4. **Versions** — Checks ClawdHub registry if `clawdhub` CLI is available 5. **Recommendations** — keep (active+healthy), update (outdated), review (unused), remove (broken deps) ## Safety - **Read-only** — Never modifies, installs, or removes anything - **Advisory only** — Recommendations require manual action
Related Skills
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
filesystem
Advanced filesystem operations for listing files, searching content, batch processing, and directory analysis. Supports recursive search, file type filtering, size analysis, and batch operations like copy/move/delete. Use when you need to: list directory contents, search for files by name or content, analyze directory structures, perform batch file operations, or analyze file sizes and distribution.
Budget & Expense Tracker — AI Agent Financial Command Center
Track every dollar, enforce budgets, spot spending patterns, and build wealth — all through natural conversation with your AI agent.
yt-dlp
A robust CLI wrapper for yt-dlp to download videos, playlists, and audio from YouTube and thousands of other sites. Supports format selection, quality control, metadata embedding, and cookie authentication.
time-checker
Check accurate current time, date, and timezone information for any location worldwide using time.is. Use when the user asks "what time is it in X", "current time in Y", or needs to verify timezone offsets.
pihole-ctl
Manage and monitor local Pi-hole instance. Query FTL database for statistics (blocked ads, top clients) and control service via CLI. Use when user asks "how many ads blocked", "pihole status", or "update gravity".
mermaid-architect
Generate beautiful, hand-drawn Mermaid diagrams with robust syntax (quoted labels, ELK layout). Use this skill when the user asks for "diagram", "flowchart", "sequence diagram", or "visualize this process".
memory-cache
High-performance temporary storage system using Redis. Supports namespaced keys (mema:*), TTL management, and session context caching. Use for: (1) Saving agent state, (2) Caching API results, (3) Sharing data between sub-agents.
mema
Mema's personal brain - SQLite metadata index for documents and Redis short-term context buffer. Use for organizing workspace knowledge paths and managing ephemeral session state.
file-organizer-skill
Organize files in directories by grouping them into folders based on their extensions or date. Includes Dry-Run, Recursive, and Undo capabilities.
media-compress
Compress and convert images and videos using ffmpeg. Use when the user wants to reduce file size, change format, resize, or optimize media files. Handles common formats like JPG, PNG, WebP, MP4, MOV, WebM. Triggers on phrases like "compress image", "compress video", "reduce file size", "convert to webp/mp4", "resize image", "make image smaller", "batch compress", "optimize media".
edge-tts
Text-to-speech conversion using node-edge-tts npm package for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.