code-quality

Review code diffs for readability and maintainability issues.

2|Updated Sep 13, 2025
One-click install
npx skills add https://github.com/s977043/river-reviewer --skill code-quality-s977043
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-quality
Source: https://github.com/s977043/river-reviewer/tree/main/skills/agent-skills/code-quality
Command: npx skills add https://github.com/s977043/river-reviewer --skill code-quality-s977043

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps maintain readable, maintainable code by spotting common quality issues early.

Core Features & Use Cases

  • Naming & structure checks: evaluates clarity of identifiers and module boundaries.
  • Consistency & logging: ensures consistent error handling and logging strategies.
  • Quick Start: supply a diff and receive prioritized feedback.

Quick Start

Run the skill on a patch or diff to receive feedback on readability and maintainability improvements.

Frequently Asked Questions about code-quality

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

FAQPage Schema
How do I identify code quality issues like complex conditionals and duplicated logic?

Code quality issues arise from complex conditionals, ambiguous naming, and replicated logic across modules. Run a diff through this Skill to receive prioritized feedback on readability and maintainability problems, following a structured review workflow that checks naming clarity, branching readability, and consistent error handling.

What should I check for when reviewing code readability and maintainability?

Focus on descriptive naming and module boundaries, branching logic and early returns, and consistent error handling and logging strategies. The Skill evaluates these aspects against a code-quality checklist to spot deterioration in readability and intent clarity.

Can I use this for static analysis on diffs and patches?

Yes. Supply a diff or patch to receive structured feedback on code quality. The Skill analyzes multi-branch conditionals, error handling patterns, and duplicated logic, reporting issues that impact readability and maintainability across modules.

How do I prevent duplicated logic and improve code consistency?

Review replicated logic across components and ensure consistent error handling and logging per established patterns. The Skill identifies these issues in diffs and provides prioritized recommendations to reduce duplication and maintain uniform code structure.

What does the code-quality-checklist verify?

The checklist verifies explicit responsibilities through descriptive naming, evaluates readability of branching and early returns, and ensures consistent error handling and logging. It grounds the review workflow in concrete, actionable quality criteria.