objective-code-review

Review commits, pull requests, and merge requests for requirement correctness and structural defects.

Updated May 27, 2026
One-click install
npx skills add https://github.com/ybaspinar/agent-work-skills --skill objective-code-review-ybaspinar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: objective-code-review
Source: https://github.com/ybaspinar/agent-work-skills/tree/main/skills/objective-code-review
Command: npx skills add https://github.com/ybaspinar/agent-work-skills --skill objective-code-review-ybaspinar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code reviews often drift into personal taste, style nits, or rubber-stamping because tests pass, while unmet requirements, misleading names, copied legacy residue, and ambiguous state models slip through and become expensive contracts. This Skill enforces an objective, evidence-based review that surfaces material concerns in priority order without issuing merge verdicts. ## Core Features & Use Cases - Requirement-first review: Triangulates the change's contract from tickets, acceptance criteria, tests, and repository conventions before judging implementation, then checks correctness, design integrity, scope, risk, project fit, non-functional obligations, and regression protection in a fixed order. - Structural defect classification: Identifies and classifies semantic integrity, copy-residue, state-model, boundary/ownership, representation-mismatch, and change-amplification defects with mismatch, invariant, amplification, and corrective direction. - Advisory output format: Produces a structured review assessment with at most five prioritized findings across material concerns, questions, and worth-considering sections, never an approve/reject verdict. - Use Case: When reviewing a PR that adds a greenfield OrdersV3Controller copied from another service with no V1 or V2, the Skill flags the false version history as a material semantic-integrity defect and recommends renaming to an unversioned controller. ## Quick Start Review this pull request for unmet requirements, structural design defects, scope discipline, and missing regression tests, and return prioritized material concerns without a merge verdict.

Frequently Asked Questions about objective-code-review

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

FAQPage Schema
How do I review a pull request objectively without style nitpicks?

Establish the change's required contract from tickets, acceptance criteria, and repository conventions first, then review in a fixed order: correctness, design integrity, scope, material risk, project fit, non-functional requirements, and regression protection. Report only evidence-backed defects, risks, or precise questions.

What is a structural design defect in code review?

A structural design defect is code that runs today but makes future correct changes expensive through false names, copied residue, ambiguous state models, unclear ownership, or duplicated policy. It is classified into subtypes like semantic integrity, state model, and change amplification, not dismissed as a code smell.

Should a code review approve or reject a merge request?

This review approach acts as an advisor, not the merge authority. It states material concerns plainly with the smallest corrective direction and leaves the merge decision to the human owners, never outputting approve, disapprove, or request-changes verdicts.

When is a missing regression test a material concern?

For bug fixes, a missing regression test is normally material because the escaped bug proves an unprotected path; the test must fail without the fix and pass with it. For other changes, it is material when the changed observable contract carries meaningful regression risk.

How do I handle copied code from another service in review?

Audit copied identifiers, routes, versions, comments, flags, authorization, and tests for leaked source semantics. Similar structure is acceptable, but retained history like a V3 name with no predecessor is a copy-residue defect requiring renaming to truthful contracts.