project-health-auditor

Identifies codebase health gaps across quality, dependencies, security, testing, and documentation.

258|26|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/majiayu000/spellbook --skill project-health-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-health-auditor
Source: https://github.com/majiayu000/spellbook/tree/main/skills/project-health-auditor
Command: npx skills add https://github.com/majiayu000/spellbook --skill project-health-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams quickly identify code quality gaps, debt, and risk across a repository, enabling targeted improvements.

Core Features & Use Cases

  • Code Quality: spot complexity, code smells, and maintainability issues.
  • Dependency & Security: evaluate dependency health, vulnerabilities, and licensing concerns.
  • Architectural Insight: assess structure, coupling, and adherence to architecture guidelines.
  • Use Case: before a major release, run a health audit to surface actionable debt items and a remediation plan.

Quick Start

Run the health auditor on your codebase to generate a comprehensive health report.

Frequently Asked Questions about project-health-auditor

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

FAQPage Schema
How do I audit codebase health before a major release?

A codebase health audit identifies gaps across quality, dependencies, security, testing, and documentation to generate structured reports and prioritized remediation items for release planning.

What is the best way to track technical debt in large repositories?

Technical debt tracking in large repositories involves assessing code complexity, coupling, and architecture guidelines to surface actionable debt items and structured remediation plans.

Does this codebase audit tool work across different programming languages?

Yes, this codebase audit is applicable to mid-to-large repositories across multiple programming languages, evaluating dependencies, vulnerabilities, and maintainability issues regardless of language.

How do I identify security vulnerabilities and dependency health issues in my code?

Identifying security vulnerabilities and dependency health involves evaluating dependency versions, known vulnerabilities, and licensing concerns to surface risks for architecture review.

Can I assess architectural coupling and code smells during a health audit?

Yes, a health audit assesses architectural structure and coupling while spotting code smells and maintainability issues, providing architectural insight for governance and planning.

When should I not use an automated codebase health auditor?

An automated codebase health auditor may not suit very small repositories or rapid prototyping contexts where the overhead of structured remediation planning outweighs the immediate need for feature velocity.