sowadalmughni

Vibe Debt Scanner — AI skill for Claude Code

AI community

Scans any module for the technical debt AI coding tools generate invisibly.

How to install Vibe Debt Scanner

This entry records only its repository, not the path inside it, so there is no exact command to give. Open sowadalmughni/vibe-debt-scanner and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Vibe Debt Scanner does

Scans any module for the technical debt AI coding tools generate invisibly. Assigns a Debt Severity Score (1-10), outputs a PR Gate verdict (PASS / WARN / BLOCK), and provides the exact rewritten function for every finding. No vague advice.

Alternatives in AI

Sast Skills — Collection of agent skills that turn your AI coder into a SAST scanner 620 ★
Hol Guard — Open-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, M 485 ★
Module Feature — Add a new feature (model + service + controller + views + routes + tests) to an existing module 407 ★

README

vibe-debt-scanner

A Claude Code skill that detects the specific technical debt patterns that AI coding tools generate invisibly — and outputs the exact rewritten code to remove each one.

**Vague advice is a failure state.** Every finding includes the exact offending code block and the exact replacement function. No "consider refactoring this." Just the fix.

The Problem

AI coding tools optimize for the immediate prompt. A function generated at cyclomatic complexity 5 becomes complexity 15 as edge cases are injected one prompt at a time. A list endpoint generated without pagination works on 10 rows and crashes on 10,000. Code is duplicated rather than reused because the model cannot see the existing helper patterns of the codebase.

GitClear analyzed 211 million changed lines and confirmed the pattern: copy-paste duplication rose 8x from 2021 to 2024. Refactoring activity collapsed from 25% of commits to under 10%. Every AI-assisted commit makes the next one harder.

The "Spaghetti Point" hits around month 3. Teams consistently report spending 20–30% of sprint capacity on bugs. This skill detects the signals before the wall.

Install

# Via Claude Code plugin marketplace
/plugin marketplace add sowadalmughni/vibe-debt-scanner
/plugin install vibe-debt-scanner@vibe-debt-scanner

# Manually — personal (follows you across projects)
mkdir -p ~/.claude/skills
git clone https://github.com/sowadalmughni/vibe-debt-scanner ~/.claude/skills/vibe-debt-scanner

# Manually — project-level
mkdir -p .claude/skills
git clone https://github.com/sowadalmughni/vibe-debt-scanner .claude/skills/vibe-debt-scanner

Quick Score

bash .claude/skills/vibe-debt-scanner/scripts/score-module.sh ./src/users

Output:

═══════════════════════════════════════════════════
  DEBT SEVERITY SCORE: 7 / 10
  PR GATE: 🔴 BLOCK
  Action: Refactor required before merge
═══════════════════════════════════════════════════

  TOP DEBT CONTRIBUTORS:
    → N