skill-issue
🥈Silverskill-issue audits AI agent skills to identify issues before they impact operations. It benefits operations teams by ensuring AI agents perform optimally. It connects to other AI agent skills and workflows.
2300Updated 2mo ago
Intermediate30min to implementautomation
Saves ~120 min per use
Quick InstallView Source
git clone https://github.com/krispuckett/skill-issue.gitWorks with:
Claude
Overview
About This Skill
skill-issue is an agent auditing skill that inventories all installed skills, tracks their usage from logs, and checks health by verifying required binaries and environment variables. It scans skill directories for SKILL.md files, analyzes dependencies, and generates a markdown report recommending which skills to keep, review, or remove based on health and activity over a configurable period. The tool runs read-only and never modifies, installs, or removes anything—making it safe for operations teams to use on production skill portfolios. Perfect for DevOps engineers and AI operations managers who need visibility into skill performance and dependency health without manual auditing.
How to Use
Clone the repository and point it at your skills directory using the SKILL_DIRS environment variable. Run the audit via CLI with `node scripts/audit.mjs` or ask your agent to run a skill audit. Configure MEMORY_DIR to enable usage tracking from your dated markdown logs.
Use Cases
Remove unused skills cluttering your project after analyzing 7-day usage patterns
Identify skills with missing dependencies before they break agent workflows
Track which skills are actively used across your agent infrastructure
Audit environment variables and CLI tool requirements for all skills at once
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/krispuckett/skill-issueRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Audit the following AI agent skill for potential issues. The skill is designed to [DESCRIBE SKILL PURPOSE] in the [INDUSTRY] industry. The skill uses [DATA] and interacts with [RELATED SKILLS]. Identify any potential issues that could impact operations, such as data handling problems, integration issues, or performance bottlenecks.
Example Output
# AI Agent Skill Audit Report ## Skill Overview **Purpose**: Automates customer support responses in the retail industry **Data Used**: Customer inquiries, product databases, order statuses **Related Skills**: Order processing, inventory management, customer feedback analysis ## Identified Issues - **Data Handling**: Potential privacy concerns with customer data storage - **Integration**: Compatibility issues with legacy inventory management systems - **Performance**: May experience bottlenecks during peak hours due to high query volume ## Recommendations - Implement data encryption for customer information - Develop adapters for legacy system integration - Optimize query handling for peak times ## Risk Assessment - **High Risk**: Data privacy compliance issues - **Medium Risk**: System integration failures - **Low Risk**: Performance degradation during peak hours
Apply to these tools
Browse all toolsClaude
AI assistant built for thoughtful, nuanced conversation
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan