KairaxisKairaxis
Freestructured workflowmedium risk

Capability · rank 18

improve-codebase-architecture

Find shallow interfaces and tightly coupled seams, then propose testability-focused architectural refactors.

Explores a codebase for architectural friction and compares alternative interface designs before recommending deeper, more testable modules.

Listed owner

mattpocock/skills

Package source

GitHub

Category

Developer Exp

Developer Exp
$npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture
OverviewSandboxUsageExamplesLimitationsVersionsRelated Skills

Overview

Explores a codebase for architectural friction and compares alternative interface designs before recommending deeper, more testable modules. Review the sandbox comparison, limitations, permissions, and pinned version before install.

Outcome

Find shallow interfaces and tightly coupled seams, then propose testability-focused architectural refactors.

Who it is for

Maintainers planning meaningful refactors in mature codebases.

What it is not for

Blind rewrites without tests, domain context, or a reviewable migration plan.

Runtime export

codex_skill · markdown_export

Sandbox comparison
Generic baseline vs improve-codebase-architecture on the same sample input · pinned v0.1.0

Sample input

Identify shallow modules and propose three deeper interface designs

Model: gpt-4.1-mini · temp 0.2

Generic baseline

50/100
Use a generic workflow and rely on broad best practices without domain-specific guidance.

Skill-enhanced

86/100
improve-codebase-architecture workflow:
Find shallow interfaces and tightly coupled seams, then propose testability-focused architectural refactors.
Apply the capability with explicit assumptions, constraints, and a reviewable result.

Rubric scores

+36 lift
Coverage of failure modes2 → 5
Actionable recommendations3 → 5
Measurable next steps2 → 4
Risk / limitation awareness2 → 4

Assumptions

  • Sample input is representative of a real production task
  • Same model and temperature for baseline and skill-enhanced runs

Comparison runs through the shared sandbox engine on registry sample cases (deterministic v0 path).

Usage

  1. 1. Inspect trust badges, limitations, and permissions on this page.
  2. 2. Run the sandbox comparison to see baseline vs skill-enhanced output.
  3. 3. Install the pinned version with the command below for your agent runtime.
  4. 4. Agents can also fetch /api/v1/skills/improve-codebase-architecture/manifest.
$npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture

Example prompts & use cases

1 / Prompt

Identify shallow modules and propose three deeper interface designs

Limitations

  • Recommendations still require maintainer validation against delivery constraints.

Audience

Maintainers planning meaningful refactors in mature codebases.

Not for

Blind rewrites without tests, domain context, or a reviewable migration plan.

Version history

v0.1.0

Jul 22, 2026current

Initial Kairaxis catalog packaging