# Skill Audit

Audit codebases for quality, consistency, and broken patterns, use for pre-release or...

- Repository: https://github.com/nyldn/claude-octopus (4351 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nyldn/claude-octopus --skill skill-audit -g -a claude-code -y`
Codex: `npx skills add nyldn/claude-octopus --skill skill-audit -g -a codex -y`
Cursor: `npx skills add nyldn/claude-octopus --skill skill-audit -g -a cursor -y`
Gemini CLI: `npx skills add nyldn/claude-octopus --skill skill-audit -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nyldn/claude-octopus`

## Description

Audit codebases for quality, consistency, and broken patterns, use for pre-release or tech debt review

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Systematic Audit Process

Load `skills/blocks/engineering-method-selection.md` from the installed plugin
and apply only the methods relevant to this task. Preserve this entry point's
execution contract and output format. Read referenced skills as instructions;
do not invoke the current command recursively or add provider calls from a seat.

## Overview

Comprehensive, methodical auditing to find issues, inconsistencies, and broken features across a codebase.

**Core principle:** Define scope → Create checklist → Execute systematically → Report findings → Prioritize fixes.

For architecture simplification, load
`skills/blocks/architecture-simplification.md`. Pin the revision, inspect recent
churn and representative callers, then apply the deletion test. Do not recommend
removing a small wrapper when it centralizes a security, cleanup, precedence, or
failure invariant. A `simplify` verdict needs source evidence, a concrete caller,
and migration and rollback steps.

---

## When to Use

**Use this skill when user wants to:**
- Audit entire application for issues
- Find all instances of a problem pattern
- Check for broken features systematically
- Comprehensive quality verification
- Identify inconsistencies across codebase

**Do NOT use for:**
- Security vulnerability scanning (use skill-security-audit)
- Code quality review (use skill-code-review)
- Single file searches (use Grep/Glob directly)
- Performance profiling

---

## The Process

### Phase 1: Scope Definition

#### Step 1: Understand Audit Objectives

```markdown
**Audit Objectives:**

What to audit: [app features, code patterns, specific issues]
Why auditing: [what prompted this, what problem are we solving]
Scope: [entire app, specific module, particular feature set]
Depth: [surface-level or deep inspection]
```

#### Step 2: Define Audit Criteria

Use AskUserQuestion if needed:

```markdown
**Audit Focus:**

The rest: https://github.com/nyldn/claude-octopus/blob/HEAD/.claude/skills/skill-audit/SKILL.md