SIFT Codebase Audit Agent Skill

Animated diagram of how sift works — How sift works

A portable Agent Skill for SIFT — Structural Inspection for Technical Simplification: a complete, read-only codebase audit focused on material simplifications in data structures, state representation, algorithms, control flow, schemas, lifecycle/concurrency, and ownership.

The skill creates a coverage contract, partitions the repository into non-overlapping subsystem reviews, validates every finding, rejects abstraction churn, audits its own coverage, and returns a prioritized implementation plan. It does not edit the repository or run tests; its only write is the final report artifact, docs/sift-audit-<date>.md by default.

Install

npx skills add 2389-research/sift

This installs the skill project-local for the agents it detects. Add -g for a user-wide install.

Manual install

Clone and copy. The installed directory must be named sift-codebase-audit to match the skill's name field:

git clone https://github.com/2389-research/sift.git
cp -R sift ~/.claude/skills/sift-codebase-audit

Invoke

/sift-codebase-audit

Or ask naturally:

Run SIFT on the complete repository. Exclude vendored dependencies and generated output.

The skill defaults to the current repository and whole-application coverage unless the request states a narrower scope.

Package contents

sift-codebase-audit/
├── SKILL.md
├── README.md
├── LICENSE
└── references/
    ├── finding-schema.md
    ├── report-template.md
    └── worker-brief.md

License

MIT — see LICENSE.