multi

skill-issue

Audit and review all installed agent skills. Run on-demand or via cron to get a health report: skill inventory, usage tracking, version checks, dependency health, and actionable recommendations (keep, update, review, remove). Use when asked to review skills, check for skill updates, find unused skills, or audit the skill ecosystem.

22 stars

bykrispuckett

View on GitHub Installation ↓

How skill-issue Compares

Feature / Agent	skill-issue	Standard Approach
Platform Support	multi	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Which AI agents support this skill?

This skill is compatible with multi.

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.

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