improve-codebase-architecture SKILL.md skillA
improve-codebase-architecture from chrislacey89/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add chrislacey89/skills/improve-codebase-architecture@git:20260429.76302cdPins git:20260429.76302cd in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- chrislacey89/skills
- Path
improve-codebase-architecture/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260429.76302cd, committed Apr 29, 2026
- First version recorded
- Apr 7, 2026
- Size
- 8,845 bytes
- Repository stars
- 4
- License
- MIT
Side-route skill for architecture exploration and deepening opportunities. Use when the user wants to find structural improvements, shallow-module pain, or refactor opportunities that may flow into /request-refactor-plan or /execute. Not for already-scoped implementation tasks.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Improve Codebase Architecture Explore a codebase like an AI would, surface architectural friction, discover opportunities for improving testability, and propose module-deepening refactors as GitHub issue RFCs. A **deep module** (John Ousterhout, "A Philosophy of Software Design") has a small interface hiding a large implementation. Deep modules are more testable, more AI-navigable, and let you test at the seam instead of inside. ## Working vocabulary Use these terms exactly when describing architectural opportunities, in conversation with the user, in candidate write-ups, and in the resulting RFC issue. Do not drift into "component," "service," "API," or "boundary" — they read as synonyms but each one hides a different design decision and the slippage compounds across recommendations. - **Module** — a unit of code that callers interact with through a stable interface. Files, classes, packages, or directories can all be modules; the test is whether something on the outside depends on something on the inside. - **Interface** — the surface a module presents to callers: types, methods, parameters, return shapes, errors. Not the implementation. …
Read the whole file at its exact version.
How to install
mdr add chrislacey89/skills/improve-codebase-architecture@sha256:d0a620d0b765249bThe line at the top of this page pins the label git:20260429.76302cd, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_nxc4tdwrepm3dy7p)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Apr 7, 2026 and Apr 29, 2026, about one every 7 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260429.76302cd latest | 2026-04-29 | 76302cd | 8,845 B | A | view · diff |
| git:20260429.f6ff134 | 2026-04-29 | f6ff134 | 8,852 B | A | view · diff |
| git:20260429.8d46568 | 2026-04-29 | 8d46568 | 5,631 B | A | view · diff |
| git:20260407.d6d717b | 2026-04-07 | d6d717b | 5,250 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8845 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
chrislacey89/skills · 4 stars · license MIT · pushed 2026-11-06 · branch prod
API
GET https://markdownregistry.com/api/v1/artifacts/art_nxc4tdwrepm3dy7p GET https://markdownregistry.com/api/v1/resolve?ref=chrislacey89/skills/improve-codebase-architecture GET https://markdownregistry.com/api/v1/blob/d0a620d0b765249bbfaee7ed9fe2ae95cda6429bfd0147e83321582f11cd37e2
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from chrislacey89/skills
Every file in chrislacey89/skills