vibe-audit

Audit codebases for architectural inconsistencies, security flaws, and AI-generated technical debt.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/KangweiLIAO/skill-vibe-audit --skill vibe-audit-kangweiliao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibe-audit
Source: https://github.com/KangweiLIAO/skill-vibe-audit/tree/main
Command: npx skills add https://github.com/KangweiLIAO/skill-vibe-audit --skill vibe-audit-kangweiliao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Identifies architectural inconsistencies, security risks, and AI-generated technical debt across a codebase to accelerate reliable refactoring and quality improvements.

Core Features & Use Cases

  • Two-lens audit combining Robert C. Martin's Clean Code principles with AI-driven Vibe-Coding pitfall checks.
  • Per-category findings with severity tagging and actionable migration paths.
  • Generates a structured findings JSON and a self-contained audit-report.html for easy sharing and review.

Quick Start

Ask Claude to audit this repository by saying 'Audit this codebase'.

Frequently Asked Questions about vibe-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my codebase for AI-generated technical debt and security flaws?

To audit a codebase for AI-generated technical debt and security flaws, you can trigger a static analysis that checks architectural inconsistencies and Vibe-Coding pitfalls. This process applies Clean Code principles across modules and returns a structured findings JSON with severity tags and a migration path.

What is vibe-coding pitfall detection in static codebase analysis?

Vibe-coding pitfall detection in static codebase analysis identifies AI-generated technical debt by checking for architectural inconsistencies and security flaws across modules. It combines Clean Code principles with AI-driven checks to surface category-by-category findings, returning a structured JSON and an HTML report template.

Can I generate a shareable HTML audit report for my repository's architectural inconsistencies?

Yes, you can generate a shareable audit report for architectural inconsistencies. The analysis outputs a self-contained audit-report.html template ready for rendering, alongside a structured findings JSON that includes severity tagging and actionable migration paths for easy review.

Does platform-agnostic codebase audit work without specific framework dependencies?

Platform-agnostic codebase audit works without specific framework dependencies, applying Clean Code principles and security checks across any module structure. It requires no external dependencies to run, validating schema correctness through built-in validation hooks while returning findings and an HTML report.

How do I get actionable migration paths after a static analysis finds security flaws?

To get actionable migration paths after static analysis finds security flaws, the audit applies Clean Code principles and Vibe-Coding checks across modules. It returns a structured findings JSON with category-by-category severity tagging, providing specific migration steps to resolve the identified technical debt.

What are the limitations of using Clean Code principles for codebase audit?

A limitation of using Clean Code principles for codebase audit is that the static analysis focuses on architectural inconsistencies, security flaws, and AI-generated technical debt rather than runtime behavior. It provides category-by-category findings and migration paths based on schema-validated structural checks, not dynamic execution tracing.