Improve Codebase Architecture

Overview

The Improve Codebase Architecture skill, found within the mxyhi/ok-skills repository, enables AI agents to evaluate software structures for technical debt and design inconsistencies. By synthesizing information from domain-specific documentation in CONTEXT.md and historical architectural decision records in the docs/adr/ folder, the skill identifies specific areas for refactoring. It is particularly effective for consolidating tightly-coupled modules and improving the overall testability of a project. This tool helps ensure that codebases remain navigable for both developers and AI models. Part of a repository with 423 stars, this skill supports various agents including Claude, Cursor, and Codex, focusing on aligning implementation with established project standards.

Use Cases

Install Notes

# Review source first
open https://github.com/mxyhi/ok-skills/blob/main/improve-codebase-architecture/SKILL.md

Copy or clone the skill folder into your agent skills directory after reviewing its instructions and scripts.

Security Notes

This skill requires read access to project documentation and architectural records to provide informed recommendations. Users should verify that CONTEXT.md and ADR files do not contain sensitive information or hardcoded credentials. The skill's functionality is limited to codebase analysis and does not specify additional external execution permissions.