Agent skill

Balanced Coupling

by vladikk in vladikk/modularity

The Balanced Coupling model for software design. An agent skill from vladikk/modularity.

Custom licenceAuto-check passedDevelopment

Install Balanced Coupling

skills CLI
$ npx skills add vladikk/modularity --skill balanced-coupling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vladikk/modularity balanced-coupling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vladikk/modularity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/balanced-coupling .claude/skills/balanced-coupling && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
balanced-coupling
GitHub stars
550
Token cost
~6.2k tokens
SKILL.md length
2,910 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

The Balanced Coupling model for software design. An agent skill from vladikk/modularity.

  • Works in 6 steps: Foundations: Why Coupling Matters → The Three Dimensions of Coupling → Fractal Geometry → …
  • : designing modular architectures
  • SKILL.md covers 1. Foundations: Why Coupling…, 2. The Three Dimensions of…, 3. Fractal Geometry and 4. Balancing the Dimensions, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Balanced Coupling is an agent skill from vladikk/modularity. The Balanced Coupling model for software design. Use when: designing modular architectures, evaluating coupling between components, reviewing code modularity, deciding whether to split or merge modules/services, assessing integration patterns, classifying coupling as balanced or unbalanced, applying DDD strategic and tactical patterns, reasoning about cohesion vs coupling trade-offs, identifying distributed monolith risks, or explaining why a system is hard to change. Provides the three-dimensional framework…

Its SKILL.md is about 6.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Domain-driven design and Third-party API integration. The repository describes itself as: Claude Code plugin for designing modular systems from functional requirements and reviewing existing codebases for modularity problems with actionable improvement…

When your agent uses it

  • : designing modular architectures
  • Evaluating coupling between components
  • Reviewing code modularity
  • Deciding whether to split

Example prompts

  • “/balanced-coupling”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Foundations: Why Coupling Matters
  2. The Three Dimensions of Coupling
  3. Fractal Geometry
  4. Balancing the Dimensions
  5. Connection to Domain-Driven Design
  6. Summary: The Model at a Glance

What it can do on your machine

Read from SKILL.md and the folder at commit bcdca9a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Balanced Coupling loads about 6.2k tokens when it runs. Until then it costs about 157 tokens; SKILL.md has 2,910 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~157
When it runs · the whole SKILL.md, loaded when a task matches
~6.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,910 words (~6,218 tokens).

“A comprehensive reference for understanding the Balanced Coupling model as described by Vlad Khononov. This document synthesizes the full model from the companion blog at coupling.dev, covering its foundations, dimensions, balancing mechanics, relationship to prior coupling models, and connections to…”

— opening of SKILL.md by vladikk, Custom licence
name
balanced-coupling
user-invocable
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/balanced-coupling of vladikk/modularity.

Open the folder on GitHubat commit bcdca9a

Compare with similar skills

Balanced Coupling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Balanced Coupling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Balanced Coupling this skillvladikk/modularity550—~6.2kAutomated safety check: PassCustom licence
OpenCLI Adapter Authorjackwener/OpenCLI30k1 repos~3.4kAutomated safety check: PassApache-2.0
Get API Docs with chubandrewyng/context-hub14k2 repos~775Automated safety check: PassMIT
Domain Modelingfossasia/eventyay-interpretation1.6k29 repos~821Automated safety check: PassApache-2.0
Architecture Governancezai-org/ZCode7.5k—~1.2kAutomated safety check: PassApache-2.0
Flowsint Enricher Builderreconurge/flowsint9.3k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • OpenCLI Adapter Author

    jackwener/OpenCLI

    Walks through writing an OpenCLI adapter for a new site or a new command on an existing one, from first recon and field decoding to coding and verification.

    30k GitHub starsUsed in 1 repo~3.4k tokens
    DevelopmentAuto-check passed
  • Get API Docs with chub

    andrewyng/context-hub

    Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.

    14k GitHub starsUsed in 2 repos~775 tokens
    DevelopmentAuto-check passed
  • Domain Modeling

    fossasia/eventyay-interpretation

    Build and sharpen a project's domain model. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 29 repos~821 tokens
    DevelopmentAuto-check passed
  • Apply the repository's architecture policy to code changes by generating a bounded context package, checking module and layer boundaries, and reporting baseline-aware violations.

    7.5k GitHub stars~1.2k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Flowsint Enricher Builder

    reconurge/flowsint

    Guides building Flowsint enrichers and types: where definitions live, how the base class and vault work, and when a new type is warranted.

    9.3k GitHub stars~2.6k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • DeepChat Provider Integration

    ThinkInAIXYZ/deepchat

    Guides adding an LLM provider to DeepChat through explicit source changes: collect the provider details, pick a transport path and add registry entries and tests.

    6.4k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed

More from vladikk/modularity

  • Document

    vladikk/modularity

    Produces modularity review documents in both Markdown and HTML formats.

    550 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Design

    vladikk/modularity

    Designs modular high-level architectures from functional requirements and produces design documents for each module.

    550 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Review

    vladikk/modularity

    Analyzes a codebase's modularity imbalances using the Balanced Coupling model and produces a review of design issues.

    550 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Categories

Questions about Balanced Coupling

What does Balanced Coupling do?

The Balanced Coupling model for software design. An agent skill from vladikk/modularity. Balanced Coupling is an agent skill from vladikk/modularity. The Balanced Coupling model for software design.

When should I use Balanced Coupling?

Balanced Coupling fits situations like: : designing modular architectures; evaluating coupling between components; reviewing code modularity; deciding whether to split.

How do I install Balanced Coupling in Claude Code?

Run `npx skills add vladikk/modularity --skill balanced-coupling -a claude-code`. Or copy the skill folder (skills/balanced-coupling in vladikk/modularity) into .claude/skills/balanced-coupling in your project. Claude Code loads it when a task matches its description.

How do I install Balanced Coupling in Codex?

Run `npx skills add vladikk/modularity --skill balanced-coupling -a codex`. Or copy the skill folder (skills/balanced-coupling in vladikk/modularity) into .agents/skills/balanced-coupling in your project. Codex loads it when a task matches its description.

Can I use Balanced Coupling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vladikk/modularity --skill balanced-coupling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/balanced-coupling, .gemini/skills/balanced-coupling, .github/skills/balanced-coupling and .opencode/skills/balanced-coupling in your project.

What does Balanced Coupling need to run?

SKILL.md names no scripts, command-line tools or credentials: Balanced Coupling is instructions for the agent only.

Does Balanced Coupling access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Balanced Coupling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Balanced Coupling use?

Balanced Coupling has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Balanced Coupling use?

About 6.2k tokens (SKILL.md is roughly 25k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Balanced Coupling?

Skills that share tags, products or a category with Balanced Coupling: OpenCLI Adapter Author (jackwener/OpenCLI, 30k stars), Get API Docs with chub (andrewyng/context-hub, 14k stars), Domain Modeling (fossasia/eventyay-interpretation, 1.6k stars) and Architecture Governance (zai-org/ZCode, 7.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Balanced Coupling?

vladikk (a GitHub user) maintains it in vladikk/modularity, which has 550 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 31, 2026.

Source: vladikk/modularity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.