BeClaude

skill-issue

New
3GitHubGeneralby Shubhgaji

🔍 Audit your AI agent skills, track usage, and enhance performance with skill-issue. Identify skill gaps and optimize your project efficiently.

First seen 6/6/2026
View Source

Overview

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

VariableDefaultDescription
SKILL_DIRS./skillsComma-separated skill directories to scan
MEMORY_DIR./memoryDated markdown logs for usage tracking
AUDIT_DAYS7Days 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

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/skill-issue.md https://raw.githubusercontent.com/Shubhgaji/skill-issue/main/SKILL.md
3
Invoke in Claude Code
/skill-issue
View source on GitHub
agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is skill-issue?

🔍 Audit your AI agent skills, track usage, and enhance performance with skill-issue. Identify skill gaps and optimize your project efficiently.

How to install skill-issue?

To install skill-issue: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/skill-issue.md https://raw.githubusercontent.com/Shubhgaji/skill-issue/main/SKILL.md. Finally, /skill-issue in Claude Code.

What is skill-issue best for?

skill-issue is a skill categorized under General. It is designed for: agent. Created by Shubhgaji.