Skip to content
View performance leaderboard

Community skill · architecture

Improve Codebase Architecture

Popular architecture skill from Matt Pocock for finding codebase design opportunities through domain language and local structure.

architecturerefactortypescriptdesign

Feedback flywheel

Active on run

No attributed runs yet

False-positive rate

No labels

Leaderboard

3 more feedback labels needed

Critique links active marketplace skills to each review run, rolls accepted and false-positive feedback into the skill rate, then promotes skills with enough labels into the leaderboard.

SKILL.md preview

# Improve Codebase Architecture

This is a Critique Marketplace source link for a public agent skill. It does not vendor the upstream SKILL.md; use the links below to inspect and install the maintained source.

## Upstream links

- Source: https://github.com/mattpocock/skills
- skills.sh listing: https://www.skills.sh/mattpocock/skills/improve-codebase-architecture
- Upstream install: `npx skills add mattpocock/skills`

## Use this when

- A PR exposes duplicated concepts, unclear module ownership, or missing domain boundaries.
- You want architectural feedback before a refactor becomes a broad rewrite.

## Review before installing

- Require findings to cite concrete files and explain why the abstraction fits the existing codebase.
- Avoid applying architecture advice mechanically to small tactical fixes.

## Critique usage

When this skill shapes a PR review, cite the exact upstream version or commit you inspected. Treat source-linked skills as discovery entries until your team has reviewed the upstream SKILL.md and any scripts it brings with it.

Version history

  • v1.0.0

    Curated source link added

    6/4/2026