Skip to main content
subagent CX Codex

code-auditor · gupsammy — Claude Code subagent: what it does, how to install

code-auditor goes over the code you just changed, flags logic bugs, vague names and leftovers, then says in plain words what needs fixing.

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest
Open on GitHub

What code-auditor does

code-auditor is a subagent for Claude aimed at code quality after a change: logic, clarity, naming, unused branches. It runs on sonnet with Read, Grep, Glob and Bash, and keeps project memory, so the conventions it picks up in your repo survive into the next run.

There are two modes. A quick question — is this function name any good, should this error be caught here — gets a short advisory answer whose first line is Mode: Advisor, with no report attached. Ask for a quality review, or let it fire after a diff, and the auditor takes over: it lists the files it read, gives a verdict, then works through error paths, boundary cases, nesting and stray debug lines. Dead-code hunts walk the import graph and label each hit as confirmed or as a candidate a human should look at.

Bash is read-only on purpose: git diff, git log, tree, find -type f, wc -l. Build and test commands are out of reach, so a fault that only appears at runtime will not turn up here. Security, speed and architecture sit outside the brief as well; it names the matching agent in one sentence and moves on.

What it helps with

  • review only the files a refactor touched
  • find exports that nothing imports
  • match new code to the project's naming and error-handling habits
  • get a straight answer on one name or one catch block
  • strip leftover debug prints and stale TODOs

Example prompts for the agent

  • Run code-auditor over the files from my last commit and tell me what to fix.
  • Ask code-auditor if parseInvoice is the right name for this helper.
  • Have code-auditor hunt for dead exports under src/billing.

How to install code-auditor

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest

2Manually: put the files in place

.claude/agents/code-auditor.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about code-auditor

How do I install code-auditor in Claude Code?

Add the marketplace with /plugin marketplace add gupsammy/Claudest, then install the plugin: /plugin install claude-coding@Claudest.

What does code-auditor do?

It reviews changed code for logic mistakes, weak names, drift from project conventions and pieces nobody uses. As an advisor it answers one narrow question; as an auditor it returns a report on the files it inspected.

How is it different from security-auditor?

Vulnerabilities belong to security-auditor, bottlenecks to performance-auditor, module layout to architecture-auditor. code-auditor stays on code quality and only points at the right agent when something falls outside that.

Similar subagents

All subagents for Code review and refactoring →

code-auditor by other authors comes first.

code-auditor 0xSteph code-auditor — a subagent that reviews application source for injection, weak authorization and hardcoded secrets, and helps sort real scanner findings from false positives. CX Codex ★ 2,482repo stars llm-artifacts-detection existential-birds llm-artifacts-detection detects leftover cruft from AI coding assistants: dead code, duplicate test helpers, redundant wrapper classes, and obvious comments. CX Codex +1 151installs simplify SeifBenayed simplify — a skill for Claude Code, Codex and Cursor that reads code and cuts complexity that isn't earning its keep. Point it at recent changes or at one file that grew tangled. CX Codex +1 ★ 116repo stars lsp-dead-code blackwell-systems The lsp-dead-code Claude Code skill checks exported symbols for workspace references. Run it to audit dead code or review an API before removing exports. CX Codex +1 ★ 182repo stars refactor-safely tirth8205 refactor-safely — a skill for Claude Code that plans refactoring via dependency graphs. It checks impact radius before editing and validates diffs against the plan. CX Codex +1 1,200installs architecture-auditor qdhenry architecture-auditor audits software structure, design patterns, and layer separation. Helps spot circular imports and god objects before major refactoring. CX Codex ★ 1,357repo stars unused-code-cleaner davila7 unused-code-cleaner — a subagent that finds unused imports, functions and classes and removes them one at a time, validating after each step. Handy after a refactor or before a production deploy. CX Codex 1,990installs

From the same set47

The whole set →
performance-auditor The performance-auditor subagent inspects code for algorithmic, data-access, and resource bottlenecks. Use it after changes on hot paths or when you need to reason about how code scales. CX Codex ★ 276repo stars test-engineer test-engineer generates tests for critical business logic right after a feature or bug fix, skipping tests written purely to inflate coverage numbers. CX Codex ★ 276repo stars claude-memory-architecture claude-memory-architecture defines the technical architecture for the claude-memory plugin, detailing hook lifecycles, SQLite database operations, lock handling, and local vector indexing. CX Codex +1 ★ 276repo stars extract-learnings extract-learnings is a Claude Code skill that saves project knowledge and keeps memory notes organized. Record a finding or consolidate existing notes. CX Codex +1 ★ 276repo stars create-skill create-skill guides Claude Code through building a skill or slash command by clarifying its purpose and activation scenarios. Use it to draft a new instruction file. CX Codex +1 ★ 276repo stars security-auditor security-auditor finds exploitable vulnerabilities in auth, untrusted-input handling, secrets, and dependencies. Triggered after changes to auth, API endpoints, or file operations. CX Codex ★ 276repo stars create-agent create-agent generates configured subagent markdown files for Claude Code with frontmatter and system prompts. CX Codex +1 ★ 276repo stars create-claw-skill create-claw-skill is a Claude Code skill for creating OpenClaw skills or slash commands and adapting Claude Code skills. It helps prepare a SKILL.md with platform-specific fields and instructions. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open