simplify-codebase

Installation
SKILL.md

Simplify Codebase

Reduce the number of concepts and obligations a codebase must keep coherent. Line-count reduction is supporting evidence, not the objective. A successful run may conclude that the inspected surface is already justified.

Use the loaded CONTEXT terminology and RULE. If they have not been loaded, follow the project-knowledge protocol; continue and disclose the limitation when project knowledge is unavailable.

Select mode and scope

First choose the authority mode:

  • Survey for simplification audit, investigation, or candidate-finding requests. Remain read-only and return ranked evidence.
  • Change for explicit simplify, remove, consolidate, refactor, or repository-documentation edit requests. Prove each cut, implement it within the authorized scope, and validate the surviving contract.

Then choose the coverage scope:

  • Focused when the user names a subsystem, symbol, state machine, dependency, or suspected duplication. Cover that boundary thoroughly before expanding outward.
  • Broad when the request spans the repository or asks for multiple candidates. Partition the system and account for every in-scope domain.

Deleting a reachable capability, supported interface, stored representation, or compatibility path is a product decision. Describe the consequence and obtain direction unless the user has already chosen it.

Installs
5
GitHub Stars
1
First Seen
Aug 29, 2026
simplify-codebase — zuozh11/agent-skill-engineering