complexity-report

Identify cyclomatic complexity hotspots in TypeScript or JavaScript codebases.

11|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill complexity-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-report
Source: https://github.com/berkcangumusisik/claude-code-practices/tree/main/skills/complexity-report
Command: npx skills add https://github.com/berkcangumusisik/claude-code-practices --skill complexity-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify cyclomatic complexity hotspots and generate actionable refactoring suggestions.

Core Features & Use Cases

  • Automated hotspots detection: scan codebases to locate functions or files with high cyclomatic complexity.
  • Quantitative insights: report CC metrics, line counts, and nesting depth for hotspots.
  • Use Case: a developer runs complexity-report on src/ to surface hotspots for targeted refactoring.

Quick Start

Run the complexity-report against the target project directory to generate a prioritized list of refactor candidates.

Frequently Asked Questions about complexity-report

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

FAQPage Schema
How do I identify cyclomatic complexity hotspots in a JavaScript codebase?

To identify cyclomatic complexity hotspots, scan your JavaScript directories to locate functions with high CC metrics, large line counts, or deeply nested branches. This surfaces specific files and functions for targeted refactoring.

What are the best ways to find refactor candidates in TypeScript projects?

Finding refactor candidates involves running static analysis on your TypeScript code structure to report CC metrics and nesting depth. This generates a prioritized refactoring plan based on frequently executed paths and complex functions.

Can I use static analysis to measure nesting depth and function size in TypeScript?

Yes, you can use static analysis to measure nesting depth and function size in TypeScript. It scans the code structure to report quantitative metrics, highlighting functions with large line counts and deeply nested branches as hotspots.

Does complexity analysis work on both TypeScript and JavaScript source files?

Complexity analysis works on both TypeScript and JavaScript source files. By default, it scans the src/ directory to apply static analysis of code structure and report cyclomatic complexity metrics across your entire project.

How do I generate a prioritized refactoring plan from code metrics?

To generate a prioritized refactoring plan from code metrics, scan your codebase to surface hotspots based on cyclomatic complexity, line counts, and nesting depth. This outputs a targeted list of actionable refactor candidates.