code-review

Audit codebases for design principles, architecture, and type-safety compliance.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sunbluesome/dotfiles --skill code-review-sunbluesome
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/sunbluesome/dotfiles/tree/main/.claude/ds/skills/code-review
Command: npx skills add https://github.com/sunbluesome/dotfiles --skill code-review-sunbluesome

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic, repeatable evaluation of codebases to ensure adherence to design principles, architecture patterns, and type-safety during code reviews.

Core Features & Use Cases

  • Design Principles Review: Verifies SRP, KISS, and separation of concerns to prevent excessive coupling and scope creep.
  • Architecture Compliance: Evaluates directory structure, naming conventions, and DI usage in line with the coding skill references.
  • Type Safety & DTOs: Enforces absence of bare Any and ensures data transfer objects are used at external boundaries.
  • Quality Tools Alignment: Integrates findings with ruff, pyright, and pytest to deliver actionable remediation steps.

Quick Start

Initiate a code review against a target repository to verify SRP, architecture compliance, and type-safety in key modules.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I automate architecture compliance and design principles checks during a code review?

Architecture compliance and design principles checks are automated by auditing codebases for SRP, naming conventions, and dependency injection usage, producing actionable findings with standardized IDs to guide remediation.

Can I enforce type safety and prevent bare Any types in my Python codebase?

Type safety is enforced by verifying the absence of bare Any types and ensuring data transfer objects are used at external boundaries, integrated with static analysis tools like pyright to deliver actionable remediation steps.

How do I integrate ruff and pytest results into a structured code review?

Ruff and pytest results are integrated into the code review by aligning static-quality checks with architectural evaluations, verifying compliance with design principles and type-safety to produce standardized, actionable findings.

What is the best way to verify Single Responsibility Principle and separation of concerns in a repository?

Single Responsibility Principle and separation of concerns are verified through a systematic evaluation of codebases during post-implementation reviews, preventing excessive coupling and scope creep by generating actionable findings with standardized IDs.

Does this code review process work with any Python project structure?

This code review process applies to post-implementation reviews across common project structures, evaluating directory structures, naming conventions, and dependency injection usage in line with coding skill references.