review-codebase

Analyze codebases for optimization, refactoring, and security vulnerabilities.

6|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/l3wi/agents-workflow --skill review-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-codebase
Source: https://github.com/l3wi/agents-workflow/tree/main/.pi/skills/review-codebase
Command: npx skills add https://github.com/l3wi/agents-workflow --skill review-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenge of maintaining high code quality, identifying technical debt, and proactively planning improvements in a software project.

Core Features & Use Cases

  • Comprehensive Analysis: Scans code for complexity, duplication, outdated dependencies, and anti-patterns.
  • Documentation Audit: Checks the health and accuracy of project documentation, including READMEs, API docs, and ADRs.
  • Actionable Insights: Generates prioritized tasks and suggests concrete next steps, including refactoring patterns and planning commands.
  • Use Case: A development team can run this skill monthly to get a clear picture of their codebase's health, identify critical security vulnerabilities, and receive a prioritized list of refactoring tasks to improve maintainability.

Quick Start

Run a full codebase review focusing on security issues.

Frequently Asked Questions about review-codebase

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan a codebase for technical debt and security vulnerabilities?

Scanning a codebase for technical debt and security vulnerabilities involves analyzing software complexity, duplication, and anti-patterns to identify optimization areas. This skill performs comprehensive analysis and generates a detailed review report with prioritized refactoring tasks and suggested next steps.

What is the best way to audit project documentation and code quality?

Auditing project documentation and code quality requires checking the health and accuracy of READMEs, API docs, and ADRs alongside code analysis. This skill scopes analysis by directory or focus area to generate actionable insights and concrete improvement plans.

How do I identify refactoring patterns to reduce code complexity?

Identifying refactoring patterns to reduce code complexity requires evaluating complexity metrics and anti-patterns within the software. This skill scans the codebase to detect outdated dependencies and provides prioritized tasks utilizing specific refactoring patterns for actionable improvement.

Can I scope a code review to focus only on performance and testing issues?

Scoping a code review to focus on performance and testing issues is fully supported by this skill. It allows you to target specific directories or focus areas like security, performance, quality, testing, or docs to generate a tailored analysis report.

How does a codebase review generate actionable improvement plans?

A codebase review generates actionable improvement plans by analyzing complexity metrics, duplication, and anti-patterns, then synthesizing these findings into a detailed report. The output includes prioritized tasks and suggested next steps to proactively plan code improvements.

When do I need to perform a comprehensive codebase analysis?

A comprehensive codebase analysis is needed when maintaining high code quality and proactively identifying technical debt in a software project. Running this review periodically, such as monthly, provides a clear picture of codebase health and critical security vulnerabilities.