complexity-audit

Audit codebase complexity and identify architectural and code smells.

4|Updated Jan 12, 2017
One-click install
npx skills add https://github.com/brandon-fryslie/dotfiles --skill complexity-audit-brandon-fryslie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-audit
Source: https://github.com/brandon-fryslie/dotfiles/tree/main/config/claude/skills/complexity-audit
Command: npx skills add https://github.com/brandon-fryslie/dotfiles --skill complexity-audit-brandon-fryslie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive analysis of codebase complexity, identifying architectural issues that hinder feature development, helping developers prioritize simplification and optimization efforts.

Core Features & Use Cases

  • Complexity Assessment: Audits codebases for architectural complexity, identifying god modules, dead code, scattered concerns, and duplicated state.
  • Feature Analysis: Evaluates features for complexity, tracing their impact across the codebase and suggesting simplifications.
  • Subsystem Analysis: Inspects individual modules for structural issues, providing a detailed complexity map.
  • Report Generation: Outputs a detailed report with findings, including recommendations for simplification and areas of concern.

Quick Start

Run the complexity-audit skill to evaluate the complexity of your codebase.

Frequently Asked Questions about complexity-audit

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

FAQPage Schema
How do I audit codebase complexity to identify architectural issues?

To audit codebase complexity, run the analysis to detect architectural and code smells like god modules, dead code, and scattered concerns. This process evaluates structural issues and outputs a detailed report with recommendations for refactoring and optimization to streamline feature development.

What is codebase complexity assessment and when do I need it?

Codebase complexity assessment is the analysis of architectural structures to identify issues hindering feature development. You need this process when simplifying modules, tracing feature impact, or prioritizing optimization efforts to resolve duplicated state and scattered concerns across your codebase.

Does the complexity audit require Python to analyze modules?

Yes, the complexity audit requires Python scripts to perform codebase analysis and generate reporting. The environment needs Python dependencies installed to inspect individual modules for structural issues and produce a detailed complexity map with actionable refactoring recommendations.

Can I evaluate feature complexity and trace its impact across the codebase?

Yes, you can evaluate feature complexity by tracing its impact across the codebase to suggest simplifications. The analysis inspects subsystems, identifies duplicated state and dead code, and generates a report detailing areas of concern to streamline ongoing feature development.

What's the best way to identify god modules and dead code for refactoring?

The best way to identify god modules and dead code is to run a comprehensive architectural complexity audit. This analysis evaluates your codebase for scattered concerns and duplicated state, providing a detailed complexity map and actionable refactoring recommendations to prioritize optimization.

What are the limitations of using automated code complexity analysis?

Automated code complexity analysis is limited to identifying structural and architectural smells like dead code and god modules based on the codebase provided. It requires Python scripts to execute the audit and generate reports, but does not automatically apply the refactoring recommendations it produces.