code-coupling-analysis

Analyze code coupling with Balanced Coupling and generate D3.js HTML reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kazuph/dotfiles --skill code-coupling-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-coupling-analysis
Source: https://github.com/kazuph/dotfiles/tree/main/plugins/kazuph-dotfiles/skills/code-coupling-analysis
Command: npx skills add https://github.com/kazuph/dotfiles --skill code-coupling-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps identify architectural weaknesses by analyzing code coupling, pinpointing risky dependencies, and guiding refactoring efforts to improve maintainability and reduce bugs.

Core Features & Use Cases

  • Balanced Coupling Analysis: Implements Vlad Khononov's framework to measure coupling across integration strength, distance, and volatility.
  • Interactive HTML Reports: Generates detailed reports with D3.js dependency graphs, summary statistics, and actionable insights.
  • Language-Agnostic Design: Analyzes TypeScript/JavaScript, Python, and Go codebases.
  • Use Case: Before undertaking a major refactoring initiative, use this Skill to identify the most tightly coupled and volatile modules, allowing you to prioritize your efforts on the areas that will yield the greatest architectural improvements.

Quick Start

Run the code-coupling-analysis skill on the current directory to generate a coupling report.

Frequently Asked Questions about code-coupling-analysis

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

FAQPage Schema
How do I measure code coupling to identify risky dependencies before refactoring?

Code coupling analysis applies the Balanced Coupling framework to measure integration strength, distance, and volatility from Git history, identifying risky dependencies before you start refactoring.

What is the Balanced Coupling framework for analyzing architecture health?

The Balanced Coupling framework, introduced by Vlad Khononov, evaluates architectural health by quantifying code coupling across three dimensions: integration strength, distance, and volatility from Git history.

Can I analyze code coupling for Python and Go projects, or is it only for TypeScript?

You can analyze code coupling for Python, Go, TypeScript, and JavaScript projects. The analysis supports multiple languages to help quantify architectural health across diverse codebases.

How do I visualize dependency graphs to pinpoint architectural weaknesses?

You can visualize dependency graphs by generating interactive HTML reports with D3.js. These reports include visual dependency graphs, summary statistics, and actionable insights to pinpoint architectural weaknesses.

What's the best way to decide which modules to refactor first in a large codebase?

To decide which modules to refactor first, run coupling analysis to identify the most tightly coupled and volatile modules, allowing you to prioritize efforts where architectural improvements yield the greatest impact.

Do I need to install D3.js to generate interactive coupling reports?

No, you do not need to install D3.js separately. The analysis directly generates interactive HTML reports with D3.js visualizations, providing dependency graphs and insights without manual setup.