complexity-audit

Audit code modules for accidental complexity, circular dependencies, and layering violations.

3|Updated Nov 19, 2025
One-click install
npx skills add https://github.com/meaganewaller/.dotfiles --skill complexity-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-audit
Source: https://github.com/meaganewaller/.dotfiles/tree/main/home/.claude/skills/common/complexity-audit
Command: npx skills add https://github.com/meaganewaller/.dotfiles --skill complexity-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify and quantify accidental complexity, circular dependencies, god objects, and other issues that make code hard to change and maintain.

Core Features & Use Cases

  • Complexity Detection: Analyzes code for common anti-patterns like circular dependencies, cross-layer violations, and hidden invariants.
  • Severity Assessment: Classifies identified complexity issues as Harmless, Concerning, or Dangerous based on impact.
  • Use Case: Before refactoring a large, tangled system, use this skill to pinpoint the most problematic areas and guide your efforts effectively.

Quick Start

Audit the 'user_authentication' module for complexity issues.

Frequently Asked Questions about complexity-audit

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

FAQPage Schema
How do I audit my codebase for circular dependencies and god objects?

To audit code for complexity, this skill analyzes modules to detect circular dependencies, god objects, and layering violations. It identifies mutual imports, cross-layer leakage, and large classes, providing severity ratings and remediation suggestions to guide refactoring efforts.

What is accidental complexity and how do I identify it in my code?

Accidental complexity refers to unnecessary intricacies in code that make it hard to maintain. This skill identifies it by scanning for anti-patterns like hidden invariants, implicit state, over-configuration, and temporal coupling, classifying each issue by severity to pinpoint problematic areas.

How do I pinpoint the most problematic areas before refactoring a tangled system?

Before refactoring, you can audit specific modules to pinpoint problematic areas. This skill assesses complexity issues by severity—Harmless, Concerning, or Dangerous—highlighting exact layering violations and coupling problems so you can prioritize your refactoring efforts effectively.

Does this code complexity analysis detect cross-layer leakage and temporal coupling?

Yes, this code complexity analysis detects cross-layer leakage and temporal coupling. It explicitly audits for these structural violations alongside mutual requires, hidden invariants, and over-configuration, assigning a severity rating to each identified issue.

What is the best way to assess technical debt and maintainability in large modules?

The best way to assess technical debt in large modules is auditing them for structural anti-patterns. This skill identifies god objects, large modules, and implicit state, providing targeted remediation suggestions to reduce coupling and improve overall maintainability.

Can I use this to check for layering violations and mutual imports in a specific module?

Yes, you can check for layering violations and mutual imports in a specific module by running an audit. The skill analyzes the targeted module for cross-layer leakage, mutual requires, and other coupling issues, returning severity ratings to indicate the impact.