Where can I find the generated analysis report?

The skill saves an interactive HTML file named 'coupling-analysis.html' in your project root or the specific package directory being analyzed.

Which programming languages are supported?

The skill is designed to be language-agnostic and includes specific patterns for TypeScript, JavaScript, Python, and Go, but can be adapted for others.

How does the skill calculate file volatility?

It uses Git history to count the number of changes made to each file over the past 6 months, categorizing them as low, medium, or high volatility.

What is the Balanced Coupling framework?

It is an architectural evaluation method by Vlad Khononov that calculates risk based on integration strength, physical distance between modules, and the frequency of changes (volatility).

What types of architectural issues can this skill detect?

It identifies common anti-patterns such as God Modules, Shotgun Surgery, Distant Intrusive dependencies, and Volatile Cores.

Code Coupling Analysis

Name: Code Coupling Analysis
Author: kazuph

bykazuph

•

Analytics & Monitoring

Analyzes architectural health using the Balanced Coupling framework to generate interactive dependency reports and refactoring insights.

The Code Coupling Analysis skill implements Vlad Khononov’s Balanced Coupling framework to provide a rigorous, data-driven evaluation of your software architecture. By calculating scores across three dimensions—integration strength, module distance, and git-based volatility—it identifies high-risk dependencies that lead to technical debt. The skill produces a comprehensive, interactive HTML report featuring D3.js force-directed graphs, allowing developers to visualize complex relationships and receive actionable refactoring suggestions to improve system maintainability and reduce the risk of 'Shotgun Surgery'.

Key Features

0115 GitHub stars

02Language-Agnostic Design: Supports TypeScript, JavaScript, Python, and Go via intelligent regex-based import extraction.

03Balanced Coupling Framework: Evaluates architecture based on strength, distance, and historical volatility.

04Git-History Integration: Automatically calculates file volatility based on the last 6 months of commit activity.

05Interactive D3.js Graphs: Visualizes dependencies with color-coded nodes reflecting change frequency and risk.

06Actionable Refactoring Guides: Provides specific 'So What?' context and step-by-step suggestions for decoupling risky modules.

Use Cases

01Validating architectural boundaries during major refactoring efforts to ensure cleaner separation of concerns.

02Onboarding developers to complex codebases by providing an interactive visual map of module dependencies.

03Prioritizing technical debt by identifying 'God Modules' that are both highly volatile and tightly coupled.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kazuph/dotfiles code-coupling-analysis

For use in Claude.ai and ChatGPT

Download Skill