solidify-codebase

Investigate a codebase and implement selected clarity-focused improvements.

102|4|Updated Apr 15, 2009
One-click install
npx skills add https://github.com/mikker/dotfiles --skill solidify-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: solidify-codebase
Source: https://github.com/mikker/dotfiles/tree/main/agents.symlink/skills/solidify-codebase
Command: npx skills add https://github.com/mikker/dotfiles --skill solidify-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep investigation and a structured solidification pass to audit, simplify, and future-proof an existing codebase. It helps identify high-impact improvements, remove cruft, and present a vetted change list before implementation.

Core Features & Use Cases

  • Two-phase approach: Phase 1 investigates and maps the system; Phase 2 applies user-selected improvements with an emphasis on clarity and maintainability.
  • Opportunity discovery: Surface 5–10 actionable opportunities to improve structure, tests, and workflows.
  • Guided execution: Implement changes incrementally, prioritizing deletion over addition and preserving behavior.

Quick Start

Ask the AI to perform a two-phase solidification pass on your codebase and present a vetted change list before implementing any changes.

Frequently Asked Questions about solidify-codebase

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit and refactor an existing codebase to remove cruft?

A codebase audit uses a two-phase solidification pass to investigate the system, identify opportunities, and apply user-selected changes with a bias toward deletion and clarity. This structured approach ensures maintainability improvements are vetted before implementation.

What is the best way to plan a codebase cleanup without breaking existing behavior?

The best way to plan a codebase cleanup is a two-phase pass that assesses risk and presents a vetted change list before applying any modifications. This method preserves behavior by prioritizing incremental, testable improvements and deletion over addition.

Can I use a solidification pass to future-proof software projects across different languages?

Yes, a solidification pass is applicable to refactors and future-proofing software projects across multiple languages. It maps the system to surface actionable opportunities, improving structure and workflows while maintaining existing behavior.

How does a two-phase codebase investigation work?

A two-phase codebase investigation works by first mapping the system and surfacing improvement opportunities, then applying only selected changes incrementally. This ensures all modifications are testable and guided by a vetted change list.

When do I need a structured codebase refactor instead of ad-hoc changes?

You need a structured codebase refactor when you require risk assessment and a vetted change list before implementation. This approach is ideal for future-proofing and audits where preserving behavior and prioritizing deletion over addition are critical.