How do I install the Skill Issue skill?

Run npx skillmds@latest add diegosouzapw/skill-issue in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Issue safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Issue?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Issue free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Issue?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Issue by diegosouzapw — Agent Skill

Name: Skill Issue
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

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.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Skill Issue — Skill Auditor

Audit all installed skills and produce a markdown report with recommendations.

Quick Start

# 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

Inventory — Finds every subdirectory containing a SKILL.md with YAML frontmatter
Usage — Scans recent memory/log files for skill name mentions
Health — Verifies required binaries (requires.bins) and env vars (requires.env)
Versions — Checks ClawdHub registry if clawdhub CLI is available
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

Frequently asked questions