Deep Module Design

Design deep modules with small interfaces and rank shallow, pass-through or leaky code for deepening. Use when designing a module interface, improving codebase architecture, or making code easier to test.

1,157 stars 217 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add borghei/Claude-Skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add borghei/Claude-Skills --skill deep-module-design
Manual install
git clone --depth 1 https://github.com/borghei/Claude-Skills.git /tmp/Claude-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Claude-Skills/engineering/deep-module-design ~/.claude/skills/deep-module-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Deep Module Design

Module-level design for code that is getting harder to change. A deep module
gives callers a lot of behaviour behind a small interface; a shallow one makes
them learn almost as much as it does. This skill measures where a codebase is
shallow, ranks the places where deepening would pay back, writes the review,
and then designs the replacement interface at least twice before anyone writes
it. The goal: callers get a lot done through very little surface, a change
stays inside one module, and tests exercise the same interface callers use.

## When to use this skill

- **Designing a new module** and wanting its interface right before callers multiply
- **"Improve the architecture of this codebase"** — find and rank deepening opportunities
- **A change keeps touching five files** for one business rule
- **Tests are brittle** because they reach past interfaces into internals
- **Layers that only forward calls** — services that call repositories that call clients, each adding nothing
- **Choosing between interface proposals** for the same module

## Inputs the skill expects

- The code: a path to scan, or the module and its callers for a design task
- Change history if available (`git log`), to weight hotspots
- The project's glossary and recorded decisions, so names and past choices are respected
- For a design task: the responsibilities the module must own and its dependencies
- Constraints: public API stability, number of callers, test coverage today
Read the full skill on GitHub

Details

Skill name
deep-module-design
Path
engineering/deep-module-design/SKILL.md
Repo updated
8 November 2026

FAQ

What does the Deep Module Design skill do?

Design deep modules with small interfaces and rank shallow, pass-through or leaky code for deepening. Use when designing a module interface, improving codebase architecture, or making code easier to test.

How do I install the Deep Module Design skill?

Claude Code plugin: /plugin marketplace add borghei/Claude-Skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Deep Module Design popular?

It lives in borghei/Claude-Skills, which has 1,157 GitHub stars and 217 forks, and is included in 1 curated skill list.

Related skills

Cto Advisor

1.2k

borghei/Claude-Skills

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Use when assessing technical debt, scaling engineering teams, evaluating technologies, or making architecture decisions.

Software DevelopmentIn 1 list217

Customer Success Manager

1.2k

borghei/Claude-Skills

Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success

Marketing, Sales & BusinessIn 1 list217

Financial Analyst

1.2k

borghei/Claude-Skills

Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making

Finance & CryptoIn 1 list217

Delivery Manager

1.2k

borghei/Claude-Skills

Plans releases, picks deployment strategies, runs incidents and tracks DORA metrics and error budgets. Use when preparing a Go/No-Go, choosing canary or blue-green, handling a production incident or reporting delivery health.

Software DevelopmentIn 1 list217

Daci Framework

1.2k

borghei/Claude-Skills

Assign Driver, Approver, Contributor and Informed roles for the decisions that keep stalling, then roll the chart out. Use when decisions thrash, ownership is unclear after a reorg, or a new team needs decision rights.

Software DevelopmentIn 1 list217

Dependency Auditor

1.2k

borghei/Claude-Skills

Scan project dependencies for vulnerabilities, license issues, and upgrade opportunities across Python, Node.js, Go, and Rust. Use when auditing dependencies, checking licenses, planning upgrades, or assessing supply chain security.

Software DevelopmentIn 1 list217

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.