Brooks Review
hyhmrright/brooks-lint
PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on twelve classic engineering books.
A skill your agent uses when asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith, extract modules or bounded contexts, or plan a feature-based…
Install Refactoring Toward Modular Architecture
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .claude/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.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/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .claude/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .agents/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .agents/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .cursor/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .cursor/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/DevBetterCom/DevBetterWeb.git --path .agents/skills/refactoring-toward-modular-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .gemini/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .gemini/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .github/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .github/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install DevBetterCom/DevBetterWeb refactoring-toward-modular-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/DevBetterCom/DevBetterWeb.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/refactoring-toward-modular-architecture .opencode/skills/refactoring-toward-modular-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "refactoring-toward-modular-architecture" agent skill from https://github.com/DevBetterCom/DevBetterWeb/tree/main/.agents/skills/refactoring-toward-modular-architecture into .opencode/skills/refactoring-toward-modular-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactoring-toward-modular-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
refactoring-toward-modular-architecture- GitHub stars
- 157
- Token cost
- ~1.6k tokens
- SKILL.md length
- 770 words
- Files
- 2
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- None found
At a glance
A skill your agent uses when asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith, extract modules or bounded contexts, or plan a feature-based…
- Works in 8 steps: Inventory the current state (before… → Fix urgent findings immediately → Draft candidate modules → …
- Asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith
- SKILL.md covers Overview, Process, Gotchas (each one bit a real… and Red Flags — stop and redo the…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Refactoring Toward Modular Architecture is an agent skill from DevBetterCom/DevBetterWeb. Use when asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith, extract modules or bounded contexts, or plan a feature-based reorganization — symptoms include a god aggregate with navigation collections into many features, open-generic IRepository<T letting any code mutate any entity, DI registration scattered across many files, and third-party SDK types (Stripe, Vimeo, etc.) leaking across layers.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `document-template.md`).
It sits in Development, covering Refactoring and Domain-driven design. It works with Stripe. The repository describes itself as: A simple web application for devBetter.
When your agent uses it
- Asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith
- Extract modules
- Bounded contexts
- Plan a feature-based reorganization — symptoms include a god aggregate with navigation collections into many features
Example prompts
- “/refactoring-toward-modular-architecture”
Workflow steps
8 steps, taken from the step headings in SKILL.md.
- Inventory the current state (before proposing anything)
- Fix urgent findings immediately
- Draft candidate modules
- Name the keystone decision
- Map cross-module interactions — then check for cycles
- Target structure: Contracts + implementation project per module
- Phase the roadmap
- Record open questions
What it can do on your machine
Read from SKILL.md and the folder at commit 730e263. 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
Refactoring Toward Modular Architecture loads about 1.6k tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 770 words of instructions outside code blocks.
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
Without a licence we can't republish the file, so here is its outline and opening line. It has 770 words (~1,635 tokens).
“Evidence first, boundaries second, sequencing third. The deliverable is a dated recommendations document (see document-template.md), not code changes. Every boundary claim must cite a file; every phase must leave the app releasable.”
- name
- refactoring-toward-modular-architecture
Files
SKILL.md and 1 other file in .agents/skills/refactoring-toward-modular-architecture of DevBetterCom/DevBetterWeb.
- SKILL.md
- document-template.md
Open the folder on GitHubat commit 730e263
Compare with similar skills
Refactoring Toward Modular Architecture 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Refactoring Toward Modular Architecture this skillDevBetterCom/DevBetterWeb | 157 | — | ~1.6k | Automated safety check: Pass | None | |
| Brooks Reviewhyhmrright/brooks-lint | 1.5k | 1 repos | ~430 | Automated safety check: Pass | MIT | |
| Angular Clean Architecturefmflurry/settings-opencode | 171 | — | ~3.6k | Automated safety check: Pass | MIT | |
| Modular Decompositiontech-leads-club/agent-skills | 7k | — | ~1.7k | Automated safety check: Pass | Custom licence | |
| Tactical Dddtech-leads-club/agent-skills | 7k | — | ~981 | Automated safety check: Pass | Custom licence | |
| Architecture Patternssecondsky/claude-skills | 227 | 10 repos | ~2.4k | Automated safety check: Pass | MIT |
Similar skills
Angular Clean Architecture
fmflurry/settings-opencode
Scaffolds and extends Angular standalone feature MODULES under src/app/modules/{name} using Clean Architecture layering (presentation/application/core/infrastructure), a self-registering module…
Modular Decomposition
tech-leads-club/agent-skills
Runs a five-step analysis of a monolith: size components, find shared domain logic, flatten hierarchy, measure coupling and group components into candidate domains.
Tactical Ddd
tech-leads-club/agent-skills
Detects anemic domain models, validates and refactors them into rich domain models, and enforces tactical DDD patterns (Entities, Value Objects, Aggregates, Domain Services, Domain Events).
Architecture Patterns
secondsky/claude-skills
Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design.
Pythonic Code
basicmachines-co/basic-memory
Write, refactor, and review Python for clarity, explicit behavior, local reasoning, strong types, constructive domain modeling, and minimal abstraction.
More from DevBetterCom/DevBetterWeb
Aspire Integration Testing
DevBetterCom/DevBetterWeb
Write integration tests using .NET Aspire's testing facilities with xUnit.
Implement Feature
DevBetterCom/DevBetterWeb
End-to-end workflow for implementing, fixing, or otherwise working on a specific GitHub issue.
Related
Works with
Categories
Questions about Refactoring Toward Modular Architecture
What does Refactoring Toward Modular Architecture do?
A skill your agent uses when asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith, extract modules or bounded contexts, or plan a feature-based…. Refactoring Toward Modular Architecture is an agent skill from DevBetterCom/DevBetterWeb.) leaking across layers.
When should I use Refactoring Toward Modular Architecture?
Refactoring Toward Modular Architecture fits situations like: asked to restructure a layered monolith (Core/Infrastructure/Web style) into a modular monolith; extract modules; bounded contexts; plan a feature-based reorganization — symptoms include a god aggregate with navigation collections into many features.
How do I install Refactoring Toward Modular Architecture in Claude Code?
Run `npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a claude-code`. Or copy the skill folder (.agents/skills/refactoring-toward-modular-architecture in DevBetterCom/DevBetterWeb) into .claude/skills/refactoring-toward-modular-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Refactoring Toward Modular Architecture in Codex?
Run `npx skills add DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a codex`. Or copy the skill folder (.agents/skills/refactoring-toward-modular-architecture in DevBetterCom/DevBetterWeb) into .agents/skills/refactoring-toward-modular-architecture in your project. Codex loads it when a task matches its description.
Can I use Refactoring Toward Modular Architecture 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 DevBetterCom/DevBetterWeb --skill refactoring-toward-modular-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refactoring-toward-modular-architecture, .gemini/skills/refactoring-toward-modular-architecture, .github/skills/refactoring-toward-modular-architecture and .opencode/skills/refactoring-toward-modular-architecture in your project.
What does Refactoring Toward Modular Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Refactoring Toward Modular Architecture is instructions for the agent only.
Does Refactoring Toward Modular Architecture 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 Refactoring Toward Modular Architecture 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 Refactoring Toward Modular Architecture use?
No licence was found for Refactoring Toward Modular Architecture or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Refactoring Toward Modular Architecture use?
About 1.6k tokens (SKILL.md is roughly 6.5k 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 Refactoring Toward Modular Architecture?
Skills that share tags, products or a category with Refactoring Toward Modular Architecture: Brooks Review (hyhmrright/brooks-lint, 1.5k stars), Angular Clean Architecture (fmflurry/settings-opencode, 171 stars), Modular Decomposition (tech-leads-club/agent-skills, 7k stars) and Tactical Ddd (tech-leads-club/agent-skills, 7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Refactoring Toward Modular Architecture?
DevBetterCom (a GitHub organization) maintains it in DevBetterCom/DevBetterWeb, which has 157 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 3, 2026.
Source: DevBetterCom/DevBetterWeb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.