# Assess Codebase

> Assess a codebase for patterns, anti-patterns, and quality opportunities; use when asked to generate coding rules, standards, or quality guidelines.

- Skill: `diegosouzapw/assess-codebase` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/assess-codebase`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/assess-codebase/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/assess-codebase

---


# Assess Codebase

## Overview

Run a multi-agent assessment using CLI subagents and synthesize code quality rules.

## Inputs

- Focus area or directories (optional)
- File patterns (optional)

## Workflow

1. Identify scope and primary languages using `rg --files -g` and recent git activity.
2. Run three CLI subagents (Gemini Flash, Codex, Claude Haiku) using the commands below.
3. Collect outputs, dedupe, and group by patterns, anti-patterns, and opportunities.
4. Draft rules and guidelines with short examples.
5. Save results to `CLAUDE.md` or `AGENTS.md` if requested.

## Subagent Commands

### Gemini Flash (patterns)

```bash
CLOUDSDK_CORE_PROJECT="" GOOGLE_CLOUD_PROJECT="" GCLOUD_PROJECT="" GEMINI_API_KEY=${GEMINI_API_KEY} \
  gemini -m gemini-3-flash-preview -o text "Assess this codebase for patterns in naming, imports, structure, and consistency. Return a structured list with file paths."
```

### Codex (anti-patterns)

```bash
codex exec -m gpt-5.2 -s read-only -c model_reasoning_effort="medium" --skip-git-repo-check \
  "Assess this codebase for anti-patterns (deep nesting, dense one-liners, inconsistent error handling, duplication). Return a structured list with file paths."
```

### Claude Haiku (opportunities)

```bash
claude --model haiku -p "Assess this codebase for clarity, consistency, maintainability, testing, and docs opportunities. Return a structured list with file paths."
```

## Output

- Patterns list
- Anti-patterns list
- Proposed rules and guidelines with priorities