Task Workflow
ikarenkov/Modo
Spec-driven workflow for non-trivial work. An agent skill from ikarenkov/Modo.
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
Install Improve Codebase Architecture
$ npx skills add ywwynm/EverythingDone --skill improve-codebase-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ywwynm/EverythingDone improve-codebase-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/ywwynm/EverythingDone.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .claude/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .claude/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-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 ywwynm/EverythingDone --skill improve-codebase-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ywwynm/EverythingDone improve-codebase-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ywwynm/EverythingDone.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .agents/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .agents/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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 ywwynm/EverythingDone --skill improve-codebase-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ywwynm/EverythingDone improve-codebase-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ywwynm/EverythingDone.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .cursor/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .cursor/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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/ywwynm/EverythingDone.git --path .agents/skills/improve-codebase-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 ywwynm/EverythingDone --skill improve-codebase-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ywwynm/EverythingDone improve-codebase-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ywwynm/EverythingDone.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .gemini/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .gemini/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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 ywwynm/EverythingDone improve-codebase-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 ywwynm/EverythingDone --skill improve-codebase-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ywwynm/EverythingDone.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .github/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .github/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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 ywwynm/EverythingDone --skill improve-codebase-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 ywwynm/EverythingDone improve-codebase-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ywwynm/EverythingDone.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/improve-codebase-architecture .opencode/skills/improve-codebase-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 "improve-codebase-architecture" agent skill from https://github.com/ywwynm/EverythingDone/tree/master/.agents/skills/improve-codebase-architecture into .opencode/skills/improve-codebase-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "improve-codebase-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
improve-codebase-architecture- GitHub stars
- 144
- Used in
- 15 other repos
- Token cost
- ~1.3k tokens
- SKILL.md length
- 651 words
- Files
- 4
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- GPL-3.0
At a glance
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.
- Works in 3 steps: Explore → Present candidates → Grilling loop
- The user wants to improve architecture
- SKILL.md covers Glossary and Process
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Improve Codebase Architecture is an agent skill from ywwynm/EverythingDone. Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `DEEPENING.md`, `INTERFACE-DESIGN.md` and `LANGUAGE.md`).
It sits in Development, covering Architecture decision records and Refactoring. It works with Android. The repository describes itself as: EverythingDone, an Android app to help you remember things, and finish them! The licence is GPL-3.0.
When your agent uses it
- The user wants to improve architecture
- Find refactoring opportunities
- Consolidate tightly-coupled modules
- Make a codebase more testable and AI-navigable
Example prompts
- “/improve-codebase-architecture”
Workflow steps
3 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 76eff8a. 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
Improve Codebase Architecture loads about 1.3k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 651 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
The full file from ywwynm/EverythingDone at commit 76eff8a, republished under its GPL-3.0 licence (© ywwynm). 651 words, ~1,274 tokens.
Download SKILL.mdSave it as
.claude/skills/improve-codebase-architecture/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- improve-codebase-architecture
- description
- Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
Improve Codebase Architecture
Surface architectural friction and propose deepening opportunities — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
Glossary
Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in LANGUAGE.md.
- Module — anything with an interface and an implementation (function, class, package, slice).
- Interface — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
- Implementation — the code inside.
- Depth — leverage at the interface: a lot of behaviour behind a small interface. Deep = high leverage. Shallow = interface nearly as complex as the implementation.
- Seam — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
- Adapter — a concrete thing satisfying an interface at a seam.
- Leverage — what callers get from depth.
- Locality — what maintainers get from depth: change, bugs, knowledge concentrated in one place.
Key principles (see LANGUAGE.md for the full list):
- Deletion test: imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep.
- The interface is the test surface.
- One adapter = hypothetical seam. Two adapters = real seam.
This skill is informed by the project's domain model. The domain language gives names to good seams; ADRs record decisions the skill should not re-litigate.
Process
1. Explore
Read the project's domain glossary and any ADRs in the area you're touching first.
Then use the Agent tool with subagent_type=Explore to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction:
- Where does understanding one concept require bouncing between many small modules?
- Where are modules shallow — interface nearly as complex as the implementation?
- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no locality)?
- Where do tightly-coupled modules leak across their seams?
- Which parts of the codebase are untested, or hard to test through their current interface?
Apply the deletion test to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want.
Show full SKILL.md (290 more words)Show less
2. Present candidates
Present a numbered list of deepening opportunities. For each candidate:
- Files — which files/modules are involved
- Problem — why the current architecture is causing friction
- Solution — plain English description of what would change
- Benefits — explained in terms of locality and leverage, and also in how tests would improve
Use CONTEXT.md vocabulary for the domain, and LANGUAGE.md vocabulary for the architecture. If CONTEXT.md defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service."
ADR conflicts: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly (e.g. "contradicts ADR-0007 — but worth reopening because…"). Don't list every theoretical refactor an ADR forbids.
Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
3. Grilling loop
Once the user picks a candidate, drop into a grilling conversation. Walk the design tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive.
Side effects happen inline as decisions crystallize:
- Naming a deepened module after a concept not in
CONTEXT.md? Add the term toCONTEXT.md— same discipline as/grill-with-docs(see CONTEXT-FORMAT.md). Create the file lazily if it doesn't exist. - Sharpening a fuzzy term during the conversation? Update
CONTEXT.mdright there. - User rejects the candidate with a load-bearing reason? Offer an ADR, framed as: "Want me to record this as an ADR so future architecture reviews don't re-suggest it?" Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. See ADR-FORMAT.md.
- Want to explore alternative interfaces for the deepened module? See INTERFACE-DESIGN.md.
© ywwynm, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 3 other files in .agents/skills/improve-codebase-architecture of ywwynm/EverythingDone.
- SKILL.md
- DEEPENING.md
- INTERFACE-DESIGN.md
- LANGUAGE.md
Open the folder on GitHubat commit 76eff8a
Used in 15 other repositories
We found 16 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 15 other GitHub owners. This page covers the copy in ywwynm/EverythingDone, which our catalogue first saw on October 7, 2026.
- DevBetterCom/DevBetterWeb.agents/skills/improve-codebase-architecture
- AvdLee/RocketSimAppdocs/.agents/skills/improve-codebase-architecture
- modernweb-dev/rocket.agents/skills/improve-codebase-architecture
- alex-on-ai/WebReaper.agents/skills/improve-codebase-architecture
- victorgarciaesgi/regle.cursor/skills/improve-codebase-architecture
- yamcodes/arkenvskills/improve-codebase-architecture
- InditexTech/weavejs.agents/skills/improve-codebase-architecture
- letehaha/moneymatter.claude/skills/improve-codebase-architecture
- cashew-labs/libretto.agents/skills/improve-codebase-architecture
- opensage-agent/opensage-adksrc/opensage/bash_tools/improve-codebase-architecture
- stevesolun/ctximported-skills/mattpocock/improve-codebase-architecture
- appleweiping/WEIPING_WIKI.claude/skills/mattpocock-skills/skills/engineering/improve-codebase-architecture
- aurorasoft2/Matt_Pocock_Skillsskills/engineering/improve-codebase-architecture
- akitaonrails/my-skillsimprove-codebase-architecture
- aiskillstore/marketplaceskills/mattpocock/improve-codebase-architecture
Compare with similar skills
Improve Codebase 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 |
|---|---|---|---|---|---|---|
| Improve Codebase Architecture this skillywwynm/EverythingDone | 144 | 15 repos | ~1.3k | Automated safety check: Pass | GPL-3.0 | |
| Task Workflowikarenkov/Modo | 343 | — | ~2.4k | Automated safety check: Pass | None | |
| Learning OpportunitiesDrCatHicks/learning-opportunities | 2.5k | — | ~2.5k | Automated safety check: Pass | CC-BY-4.0 | |
| Code Guidelinesgetsentry/sentry-react-native | 1.8k | — | ~3.2k | Automated safety check: Pass | MIT | |
| File Good First BugBrowserWorks/waterfox-android | 376 | 1 repos | ~2k | Automated safety check: Pass | Custom licence | |
| Dep Validateblokadaorg/blokada | 3.3k | — | ~5.7k | Automated safety check: Notes | MPL-2.0 |
Similar skills
Learning Opportunities
DrCatHicks/learning-opportunities
Facilitates deliberate skill development during AI-assisted coding.
- Official
Code Guidelines
getsentry/sentry-react-native
Enforce Sentry React Native SDK code guidelines for implementation, refactoring, and review.
File Good First Bug
BrowserWorks/waterfox-android
A skill your agent uses when the user wants to file good-first-bugs in Bugzilla for Firefox.
Dep Validate
blokadaorg/blokada
A skill your agent uses to validate risky dependency bumps end to end as a local or cloud-launched agent.
Code Review And Security Audit
hiroshiyui/GuilelessBopomofo
Review code for quality, correctness, and security vulnerabilities.
More from ywwynm/EverythingDone
Diagnose
ywwynm/EverythingDone
Disciplined diagnosis loop for hard bugs and performance regressions.
To Issues
ywwynm/EverythingDone
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
To Prd
ywwynm/EverythingDone
Turn the current conversation context into a PRD and publish it to the project issue tracker.
Setup Matt Pocock Skills
ywwynm/EverythingDone
Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…
Related
Works with
Categories
Questions about Improve Codebase Architecture
What does Improve Codebase Architecture do?
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Improve Codebase Architecture is an agent skill from ywwynm/EverythingDone.md and the decisions in docs/adr/.
When should I use Improve Codebase Architecture?
Improve Codebase Architecture fits situations like: the user wants to improve architecture; find refactoring opportunities; consolidate tightly-coupled modules; make a codebase more testable and AI-navigable.
How do I install Improve Codebase Architecture in Claude Code?
Run `npx skills add ywwynm/EverythingDone --skill improve-codebase-architecture -a claude-code`. Or copy the skill folder (.agents/skills/improve-codebase-architecture in ywwynm/EverythingDone) into .claude/skills/improve-codebase-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Improve Codebase Architecture in Codex?
Run `npx skills add ywwynm/EverythingDone --skill improve-codebase-architecture -a codex`. Or copy the skill folder (.agents/skills/improve-codebase-architecture in ywwynm/EverythingDone) into .agents/skills/improve-codebase-architecture in your project. Codex loads it when a task matches its description.
Can I use Improve Codebase 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 ywwynm/EverythingDone --skill improve-codebase-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/improve-codebase-architecture, .gemini/skills/improve-codebase-architecture, .github/skills/improve-codebase-architecture and .opencode/skills/improve-codebase-architecture in your project.
What does Improve Codebase Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Improve Codebase Architecture is instructions for the agent only.
Does Improve Codebase 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 Improve Codebase 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 Improve Codebase Architecture use?
Improve Codebase Architecture is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Improve Codebase Architecture use?
About 1.3k tokens (SKILL.md is roughly 5.1k 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 Improve Codebase Architecture?
Skills that share tags, products or a category with Improve Codebase Architecture: Task Workflow (ikarenkov/Modo, 343 stars), Learning Opportunities (DrCatHicks/learning-opportunities, 2.5k stars), Code Guidelines (getsentry/sentry-react-native, 1.8k stars) and File Good First Bug (BrowserWorks/waterfox-android, 376 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Improve Codebase Architecture?
ywwynm (a GitHub user) maintains it in ywwynm/EverythingDone, which has 144 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 14, 2026.
Source: ywwynm/EverythingDone on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.