code-quality

Code Quality Plugin

Comprehensive code quality tools for Claude Code: code review, debugging, codebase analysis, Python development, and markdown linting with auto-fix.

Installation

/plugin install code-quality@claude-code-plugins

Skills (3)

Skill	Purpose
code-reviewing	Systematic code review with tiered checklists (SOLID, OWASP, clean code)
python	Python development guidance (PEP-8, Ruff, pytest, mypy, uv)
markdown-linting	Markdown linting rules, VS Code setup, GitHub Actions

Agents (5)

Agent	Purpose
code-reviewer	Code quality analysis before commits/PRs with structured severity-rated findings
codebase-analyst	Deep codebase analysis for patterns, architecture, and dependencies
debugger	Root cause analysis and error investigation
quality-reviewer	Quality-focused reviewer for consensus mode (SOLID, clean code, performance)
security-reviewer	Security-focused reviewer for consensus mode (OWASP, secrets, auth flaws)

User-Invocable Skills (4)

Skill	Purpose
/code-quality:review	Comprehensive code review using code-reviewer agent
/code-quality:analyze	Deep codebase analysis using codebase-analyst agent
/code-quality:debug	Root cause analysis using debugger agent
/code-quality:lint-md	Markdown linting with optional auto-fix

Features

Code Review

Multi-agent code review with configurable modes:

• Standard mode: Single code-reviewer agent analysis
• Consensus mode: Parallel review with code-reviewer, quality-reviewer, and security-reviewer agents

Command: /code-quality:review

Supports: staged changes, specific files, PR review, baseline comparisons, parallel execution.

Codebase Analysis

Deep pattern recognition and architectural understanding.

Command: /code-quality:analyze

Provides: dependency analysis, pattern discovery, architecture insights, implementation details.

Debugging

Systematic root cause analysis for errors and unexpected behavior.

Command: /code-quality:debug

Provides: error investigation, stack trace analysis, code flow tracing, fix suggestions.

Markdown Linting

Automatic markdown linting and auto-fix on file write/edit operations.

Skill: code-quality:markdown-linting

Command: /code-quality:lint-md

Hook: PostToolUse (Write|Edit)

• Automatically runs markdownlint-cli2 --fix on markdown files
• Warns about unfixable errors
• Configurable enforcement mode

Python Development

Adaptive Python development guide with tiered complexity levels.

Skill: code-quality:python

Covers: PEP-8, Ruff, pytest, mypy, uv, project structure, type hints, security, packaging.

Configuration Templates

The plugin provides configuration templates in the templates/ directory:

• templates/markdownlint-cli2.jsonc.template - Linting rules configuration
• templates/vscode-settings.json.template - VS Code auto-fix on save
• templates/github-actions-markdown-lint.yml.template - CI/CD workflow

Environment Variables

Variable	Default	Description
CLAUDE_HOOK_MARKDOWN_LINT_ENABLED	0 (disabled)	Set to 1 to enable hook
CLAUDE_HOOK_ENFORCEMENT_MARKDOWN_LINT	warn	block, warn, or log
CLAUDE_HOOK_LOG_LEVEL	info	debug, info, warn, error

Note: The markdown-lint hook is disabled by default because it requires markdownlint-cli2 to be installed.

Requirements

Required

• Node.js 18+ with npx - For running markdownlint-cli2
• markdownlint-cli2 - Install globally or use via npx

Optional (for hook execution)

• .NET 10 SDK - Required only if using the C# hook script variant

Version History

• 1.0.0 - Initial release with code review, debugging, analysis, Python, and markdown linting