Skip to content

JPeetz/agent-skills / skills/code-quality/code-review

code-review

Unverified

Use this skill when reviewing a PR diff, commit range, file change, or code snippet before merge. Reviews security vulnerabilities, code quality, style compliance, architectural integrity, test coverage, and performance; works with GitHub/GitLab diffs or raw code and produces a systematic, severity-labeled review.

FileKindSize
CHANGELOG.mdmarkdown2.4 KB
LICENSEother1.0 KB
SKILL.mdskill md24.2 KB
evals/evals.jsonconfig7.3 KB
references/code-review-checklist.mdmarkdown12.0 KB
references/security-patterns.mdmarkdown12.4 KB
references/style-guides.mdmarkdown12.2 KB
scripts/validate_code_review.pyscript21.0 KB

CHANGELOG.md

View on GitHub
# Changelog - Code Review Agent Skill

All notable changes to this skill package will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## Unreleased

### Changed
- Description rewritten to be trigger-first ("Use this skill when ...") and under 1024 chars per the agentskills.io spec.

## v1.1.0 — 2026-06-09 (Run 003)

### Added
- SEO-optimized description with primary keyword clusters for AI engine discovery
- QUICK REFERENCE table at top of SKILL.md — dimension → what to check → key indicators
- COMMON PITFALLS & ANTI-PATTERNS section (10 reviewer anti-patterns with fixes)
- Review quality self-checklist for reviewers
- Enhanced methodology dimensions: race condition checks, idempotency analysis,
  transaction integrity verification, time-related bug detection
- Cohesion/coupling assessment and magic numbers detection in code quality
- Test quality assessment (beyond just presence/absence)
- Connection pooling and serialization cost checks in performance review
- Error message quality and README/changelog update checks in documentation review
- Severity tiebreaker rules and escalation guidelines
- Language-specific security check table (Python, JS, Java, Go, Rust, Ruby)
- Database migration review pattern
- Configuration change review pattern
- Large diff triage strategy (>500 lines)
- GEO metadata block for structured AI engine summarization
- Windsurf and OpenCode platform compatibility notes

### Changed
- Expanded platforms list to all 8: claude-code, codex, cursor, gemini-cli, openclaw, copilot, windsurf, opencode
- Version bumped to 1.1.0
- Added more detailed trigger phrases and non-trigger examples
- SKILL.md line count: 323 → 532 (+209 lines, 65% expansion)

---

## v1.0.0 — 2026-05-28
- Initial release by Skill Foundry
- AI-powered code review workflow for PR analysis
- Security vulnerability detection patterns (OWASP-inspired)
- Code quality, style, architecture, and test coverage review
- Platform-portable: Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, Copilot
- 8 eval cases (5 positive, 3 near-miss negatives)
- PEP 723 validation script

## v1.1.0 — Published 2026-07-02
- Published to JPeetz/agent-skills repository (Run 005)
- 8 eval cases (5 positive + 3 near-miss negatives)
- Cross-platform: Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, Copilot, Windsurf, OpenCode
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall