Codebase Health
Use when starting any session, or when unsure which codebase-health skill applies. Routes to audit-codebase, folder-architecture, code-design, and implement-folder-architecture. Establishes that codebase health is continuous practice, not a one-time audit.
Install
/plugin marketplace add Drakaniia/skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add Drakaniia/skills --skill codebase-healthgit clone --depth 1 https://github.com/Drakaniia/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/codebase-health ~/.claude/skills/codebase-healthPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Codebase Health Codebase health is continuous practice, not a one-time audit. Pick the skill that matches what you are about to do: | Skill | When it fires | | --- | --- | | `audit-codebase` | User says the codebase feels cluttered, disorganized, or hard to navigate | | `implement-folder-architecture` | An audit report exists and the fixes need executing | | `folder-architecture` | The agent is about to create, move, or modify any file | | `code-design` | Reviewing, writing, or refactoring a function | The loop: **audit → fix → prevent.** Audit finds the problems, `implement-folder-architecture` fixes them, and `folder-architecture` plus `code-design` keep them from coming back. ## Standing rule: 400-line files Check a file's line count **before** editing it (or the project's own limit, e.g. ESLint `max-lines`). - **>350 lines** and the edit pushes it past 400 → warn and propose a split. - **>400 lines** → make the requested change, flag the size, propose a split. Never split as a drive-by — route to `folder-architecture` + `code-design`. All thresholds are advisory; project rules (linters, `AGENTS.md`) win.
Details
- Skill name
codebase-health- Repository
- Drakaniia/skills
- Path
skills/codebase-health/SKILL.md- License
- MIT
- Repo updated
- 7 November 2026
FAQ
What does the Codebase Health skill do?
Use when starting any session, or when unsure which codebase-health skill applies. Routes to audit-codebase, folder-architecture, code-design, and implement-folder-architecture. Establishes that codebase health is continuous practice, not a one-time audit.
How do I install the Codebase Health skill?
Claude Code plugin: /plugin marketplace add Drakaniia/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Codebase Health popular?
It lives in Drakaniia/skills, which has 9 GitHub stars and 0 forks.
Related skills
Audit Codebase
9Drakaniia/skills
Scan any codebase (language-agnostic) and flag structural health issues including folder bloat, oversized files, deep nesting, naming inconsistencies, orphaned files, doc sprawl, and empty directories. Generates a markdown report with ASCII tree diagrams for folder structure issues and Mermaid graphs for file-level diagrams. Use when a codebase feels cluttered, disorganized, or hard to navigate.
Code Design
9Drakaniia/skills
Use when writing or reviewing functions that are deeply nested, do too many things, have unclear side effects, or are hard to follow linearly. Also when an agent produces code with high cognitive load — nested if-else pyramids, functions mixing validation+business logic+IO, mutable state leaks, or control flow that jumps around. Complements folder-architecture (file/dir level) with function-level design principles.
Folder Architecture
9Drakaniia/skills
Define and enforce best-practice folder architecture whenever creating or modifying files. Use whenever the AI adds or edits code to prevent structural clutter, directory bloat, misplaced files, naming inconsistencies, and deep nesting.
Graphql Expert Best Practices
9wispbit-ai/skills
GraphQL performance optimization and best practices for building scalable APIs. This skill should be used when writing, reviewing, or refactoring GraphQL schemas, resolvers, or query execution code. Triggers on tasks involving GraphQL APIs, resolver optimization, query performance, or data fetching patterns.
Implement Folder Architecture
9Drakaniia/skills
Execute a large-scale folder architecture refactor based on an audit report or user-defined architecture. Moves files into correct locations, splits oversized folders, refactors imports, updates barrel files, and verifies builds after each phase. Use after audit-codebase has generated its structural report, or when a systematic folder reorganization is needed.
Xrpl Dev
5XRPL-Commons/xrpl-dev-skills
End-to-end XRPL development playbook. Covers XRP Ledger dApp development including project scaffolding (create-xrp), wallet integration (xrpl-connect), client SDKs, transactions, tokens, NFTs, DEX/AMM, cross-chain interoperability (Axelar), and security best practices.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.