One-click install
npx skills add https://github.com/BasharAmso/Bashi --skill code-review-basharamso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Code Review
Source: https://github.com/BasharAmso/Bashi/tree/main/create-bashi-app/template/.claude/skills/code-review
Command: npx skills add https://github.com/BasharAmso/Bashi --skill code-review-basharamso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code reviews are often inconsistent, time-consuming, and miss critical issues. This skill provides a structured two-pass review (CRITICAL first, then INFORMATIONAL) with interactive issue resolution to improve code quality, security, and maintainability, while referencing scope challenges, failure modes, and TODOS for traceability.

Core Features & Use Cases

  • Enforces a two-pass review to surface high-severity findings and actionable improvements.
  • Integrates with project decisions and TODO items to maintain alignment with architecture and goals.
  • Generates a clear review summary, verdict, and a state update to ensure traceable outcomes.

Quick Start

Trigger a CODE_REVIEW_REQUESTED for changed files and accept the generated findings to update the project state.

Frequently Asked Questions about Code Review

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

FAQPage Schema
How do I conduct a structured code review for changed files?

Conduct a structured code review by analyzing file diffs using a two-pass approach to surface critical correctness issues first, followed by informational best practices. This process checks maintainability against project decisions and generates a traceable verdict.

What is a two-pass code review process and when do I need it?

A two-pass code review process isolates critical findings before evaluating informational improvements. You need this process to ensure severe correctness and security issues are addressed first, preventing high-severity problems from being buried in routine diff analysis.

How do I trace code review findings against project decisions and todos?

Trace code review findings by consulting DECISIONS.md and TODOS.md during diff analysis. This ensures the code aligns with architectural goals, and the generated review summary updates STATE.md to maintain traceable outcomes across the software engineering lifecycle.

Can I use this code review skill for large-scale software engineering projects?

Yes, you can use this skill for large-scale software engineering projects because it enforces a structured two-pass review at scale. It consults existing project sources and state files to maintain alignment with architecture and goals across extensive codebases.

What's the best way to automate finding high-severity issues in a diff?

The best way to find high-severity issues in a diff is applying a structured two-pass review that consults a code-review checklist. This surfaces CRITICAL findings first, ensuring severe correctness and maintainability problems are resolved before informational ones.

Do I need a specific checklist format to review code for best practices?

Yes, you need a checklist.md file to review code for best practices. The skill consults this checklist alongside DECISIONS.md and TODOS.md to evaluate correctness and maintainability, producing actionable findings and a final project state update.