How does the skill determine 'volatility'?

It uses Git logs to count file changes over the last 6 months. Files with high change counts are flagged as more volatile, increasing their coupling risk score.

Which programming languages does this analysis support?

The skill is language-agnostic but features optimized extraction patterns for TypeScript, JavaScript, Python, and Go codebases.

Does this skill help with refactoring decisions?

Yes, it specifically identifies anti-patterns like 'God Modules' and 'Volatile Cores' and provides actionable advice on how to decouple those components.

What is the Balanced Coupling framework used in this skill?

It is an architectural methodology by Vlad Khononov that calculates a risk score based on how tightly modules connect, their physical distance, and how often they change.

Where can I find the results of the analysis?

The skill generates a self-contained HTML report named 'coupling-analysis.html' in your project root, featuring interactive visualizations and summary statistics.

Code Coupling & Architecture Analyst

Name: Code Coupling & Architecture Analyst
Author: kazuph

bykazuph

•

Developer Tools

Analyzes code coupling using the Balanced Coupling framework to generate interactive architectural health reports and D3.js dependency graphs.

This skill empowers developers and architects to quantify and visualize technical debt by applying Vlad Khononov's Balanced Coupling framework. It evaluates code dependencies across three critical dimensions: integration strength, physical distance, and change volatility. By analyzing your Git history and import structures, the skill identifies high-risk areas—such as frequently changing 'God Modules' or distant intrusive dependencies—and generates a comprehensive, interactive HTML report. Complete with a D3.js force-directed graph and specific refactoring recommendations, it provides the 'So What?' context needed to make informed architectural decisions.

Key Features

01Multi-dimensional analysis using the Balanced Coupling formula (Strength, Distance, Volatility).

02Actionable refactoring insights that flag 'God Modules' and 'Shotgun Surgery' anti-patterns.

03Interactive D3.js dependency graphs with zoom, pan, and volatility-based color coding.

0415 GitHub stars

05Automated Git history processing to calculate file volatility over a 6-month period.

06Language-agnostic support with specialized patterns for TypeScript, JavaScript, Python, and Go.

Use Cases

01Performing architectural health audits to visualize module interactions and technical debt.

02Onboarding new developers by providing a visual map of the project's internal dependencies.

03Identifying high-risk dependencies before starting a major refactoring project.

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