pragmatic-review

Review code interactively for YAGNI and KISS principles.

2.6k|194|Updated Sep 12, 2025
One-click install
npx skills add https://github.com/heyitsnoah/claudesidian --skill pragmatic-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pragmatic-review
Source: https://github.com/heyitsnoah/claudesidian/tree/main/.agents/skills/pragmatic-review
Command: npx skills add https://github.com/heyitsnoah/claudesidian --skill pragmatic-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through focused, efficient code reviews that prioritize simplicity and avoid over-engineering.

Core Features & Use Cases

  • YAGNI & KISS evaluation: Detect unnecessary complexity and premature abstractions.
  • Multi-pass review options: Default fast review and deep mode for thorough analysis.
  • CI-ready checks: Auto-summarized findings suitable for PR feedback.

Quick Start

Run the pragmatic-review command in your code workspace to start an interactive review and follow the prompts.

Frequently Asked Questions about pragmatic-review

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

FAQPage Schema
How do I perform a code review focused on avoiding over-engineering?

A pragmatic code review focused on avoiding over-engineering uses YAGNI and KISS principles to detect unnecessary complexity and premature abstractions in your code changes.

What is the difference between a fast review and a deep code review?

A fast code review provides immediate feedback, while a deep code review performs a thorough analysis using six sequential passes to ensure comprehensive maintainability and best-practices evaluation.

Can I automate YAGNI and KISS checks for my pull requests?

Yes, you can automate YAGNI and KISS checks using an optional CI mode that generates auto-summarized findings suitable for automated code review workflows and PR feedback.

How does a YAGNI code review detect premature abstractions?

A YAGNI code review detects premature abstractions by evaluating your code against simplicity principles, identifying unnecessary complexity before it impacts software maintainability.

Is an interactive code review suitable for large software projects?

Yes, an interactive code review is suitable for software projects of any scale, offering both default fast feedback and deep multi-pass analysis to handle extensive changes.