Plugin

codebase-maintenance

Name: codebase-maintenance
Author: yeaight7

Safely refactor codebases by removing dead code, reducing complexity, eliminating unused dependencies, and migrating APIs in small test-verified steps. Includes autonomous code review and technical debt analysis with prioritized remediation roadmaps.

code-quality

developer-tools

git-workflow

What's Inside

Slash Commands4

Codebase Cleanup

/cleanup

Run a systematic cleanup on the provided code to resolve smells, simplify complexity, and enforce best practices.

Technical Debt Audit

/debt-audit

Perform a technical debt audit on the specified components and generate a prioritized remediation roadmap.

Refactoring Plan

/refactor-plan

Draft a step-by-step refactoring strategy for complex code changes to ensure behavior is preserved.

Safe Rename Command

/safe-rename

Safely rename a variable, function, class, or file across the entire repository while ensuring tests continue to pass.

Agents3

codebase-cleaner

/codebase-cleaner

Reviews code for quality, security, and performance. Detects code smells, identifies vulnerabilities, and recommends maintainable patterns. Use when aiming to proactively improve codebase health.

safe-refactorer

/safe-refactorer

Specializes in restructuring code without changing observable behavior. Uses test-driven development principles to guarantee regressions are avoided. Use when migrating frameworks or cleaning up legacy components.

technical-debt-reviewer

/technical-debt-reviewer

Audits codebases for technical debt, legacy patterns, and outdated dependencies. Proposes structured remediation roadmaps. Use when prioritizing engineering investments or modernizing systems.

Skills9

ai-slop-cleaner

/ai-slop-cleaner

Use when a working code path feels bloated, noisy, or over-abstracted, when asked to clean up or deslop AI-generated code, or when a reviewer-only anti-slop pass is requested.

architecture-simplification

/architecture-simplification

Use when a codebase carries over-engineered abstractions, unnecessary layers, or redundant logic that should be collapsed without changing behavior.

context-retrieval-loop

/context-retrieval-loop

Use when about to refactor, rename, or remove code, assessing dead code before deletion, or unsure of the blast radius of a change.

dead-code-removal

/dead-code-removal

Use when unused functions, classes, exports, or files need to be identified and safely deleted.

dependency-cleanup

/dependency-cleanup

Use when package manifests carry unused or redundant third-party dependencies that slow builds, widen the security surface, or complicate updates.

Stats

Version0.6.3

ReleasedJul 27, 2026

LanguageTypeScript

Stars6

Forks2

MaintenanceExcellent

LicenseApache-2.0

Last CommitJul 27, 2026

AddedMay 6, 2026

Actions

View on GitHub View README Plugin Marketplace JSON Homepage

Available In

agent-powerups6

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

Tags

Agent Powerups

Oh My Zsh for coding agents.

Agent Powerups is an Oh My Zsh-style collection of reusable skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for coding agents.

Today, this repo ships:

reusable skills

safe local CLI (apx) with runnable local checks

persistent Gemini relay for always-active secondary-agent delegation

validation and requirement-check scripts

verified local GitHub MCP check, smoke, and install flow

command, hook, workflow, examples, and AGENTS.md templates

plugins with native install, marketplace metadata, and apx plugins inspection (apx plugins list)

user-intent profiles with apx profiles for curated skill/plugin sets

Native install is direct for humans. Safety boundaries stay around external tools, secrets, shell profiles, and MCP enablement.

What Is Here

Path

Status

Notes

skills/

shipped

Reusable agent workflows such as systematic-debugging and writing-plans

mcp/

shipped

Local-first GitHub MCP config with check, smoke, and explicit install commands

agents-md/

shipped

Starter AGENTS.md templates

commands/

shipped

Review-first command prompts plus safe runnable checks

hooks/

shipped

Review-before-use hook recipes plus safe runnable checks

workflows/

shipped

Scenario guides

plugins/

shipped

Plugins with local-first discovery, validation, native install, and marketplace metadata (apx plugins list)

scripts/

shipped

Validation and tool-check helpers for this repo

examples/

shipped

Minimal safe setup examples

Agent Quickstart

If you are an agent working in a repo with Agent Powerups available, route tasks to capabilities yourself instead of waiting to be told:

Match first. On Claude Code the host already lists skills natively — match the task to the narrowest fitting skill (plus obvious fits like no-fluff). On Codex, Gemini, or generic agents, start with apx discover.

Discover the rest — anything not natively loaded (MCP configs, hooks, AGENTS.md templates, installed-only assets):

apx discover "<the user's task>" --target <codex|claude-code|gemini|generic> --json
apx info <chosen-asset>     # what it is, when to use it, source path, next action

Read, apply, verify. Read the asset's SKILL.md (or file) before applying it; run apx check <asset> only if it declares external requirements; then verify the result against the task.

Gate risky assets. MCP configs and hooks are review-before-use — surface them for approval, never auto-enable.

Quickstart

Using npm (Recommended)

npm install -g agent-powerups apx install claude --full

Agent-Powerups

Agent Powerups

Oh My Zsh for coding agents.

Node.js Version

Quickstart · Agent Quickstart · Plugins · Installation · Security Model · Contributing

Agent Powerups is an Oh My Zsh-style collection of reusable skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for coding agents.

Today, this repo ships:

reusable skills
safe local CLI (apx) with runnable local checks
persistent Gemini relay for always-active secondary-agent delegation
validation and requirement-check scripts
verified local GitHub MCP check, smoke, and install flow
command, hook, workflow, examples, and AGENTS.md templates
plugins with native install, marketplace metadata, and apx plugins inspection (apx plugins list)
user-intent profiles with apx profiles for curated skill/plugin sets

Native install is direct for humans. Safety boundaries stay around external tools, secrets, shell profiles, and MCP enablement.

What Is Here

Path	Status	Notes
`skills/`	shipped	Reusable agent workflows such as `systematic-debugging` and `writing-plans`
`mcp/`	shipped	Local-first GitHub MCP config with check, smoke, and explicit install commands
`agents-md/`	shipped	Starter AGENTS.md templates
`commands/`	shipped	Review-first command prompts plus safe runnable checks
`hooks/`	shipped	Review-before-use hook recipes plus safe runnable checks
`workflows/`	shipped	Scenario guides
`plugins/`	shipped	Plugins with local-first discovery, validation, native install, and marketplace metadata (`apx plugins list`)
`scripts/`	shipped	Validation and tool-check helpers for this repo
`examples/`	shipped	Minimal safe setup examples

Agent Quickstart

If you are an agent working in a repo with Agent Powerups available, route tasks to capabilities yourself instead of waiting to be told:

Match first. On Claude Code the host already lists skills natively — match the task to the narrowest fitting skill (plus obvious fits like no-fluff). On Codex, Gemini, or generic agents, start with apx discover.

Discover the rest — anything not natively loaded (MCP configs, hooks, AGENTS.md templates, installed-only assets):

apx discover "<the user's task>" --target <codex|claude-code|gemini|generic> --json
apx info <chosen-asset>     # what it is, when to use it, source path, next action

Read, apply, verify. Read the asset's SKILL.md (or file) before applying it; run apx check <asset> only if it declares external requirements; then verify the result against the task.
Gate risky assets. MCP configs and hooks are review-before-use — surface them for approval, never auto-enable.

Quickstart

Using npm (Recommended)

npm install -g agent-powerups
apx install claude --full

codebase-maintenance

What's Inside

codebase-maintenance

Popularity

What's Inside

Confidence

README

Agent Powerups

What Is Here

Agent Quickstart

Quickstart

Using npm (Recommended)

Similar Plugins

creative-writing

fullstack-dev-skills

pr-review-toolkit

feature-dev

context7

claude-council

More by yeaight7

mcp-development

tool-integrations

spec-quality-gates

documentation-systems

agentic-systems

Agent Powerups

What Is Here

Agent Quickstart

Quickstart

Using npm (Recommended)

Popularity

Health & Quality

More by yeaight7

mcp-development

tool-integrations

spec-quality-gates

documentation-systems

agentic-systems

Similar Plugins

creative-writing

fullstack-dev-skills

pr-review-toolkit

feature-dev

context7

claude-council