code-quality-standards

Identify code smells and provide refactoring suggestions for source code.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/softmg/product-tracker --skill code-quality-standards-softmg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-quality-standards
Source: https://github.com/softmg/product-tracker/tree/main/.cursor/skills/code-quality-standards
Command: npx skills add https://github.com/softmg/product-tracker --skill code-quality-standards-softmg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces technical debt and improves maintainability by identifying unclear naming, oversized functions, duplicated logic, improper error handling, and high-complexity code that make systems hard to read and fragile.

Core Features & Use Cases

  • Guidelines & Principles: Readability, small functions, KISS, DRY, YAGNI, immutability, and pure functions to guide everyday coding decisions.
  • Code Smells Catalog & Refactor Patterns: Recognizes long methods, large classes, long parameter lists, primitive obsession, feature envy, dead code, and suggests extract method, rename, introduce parameter object, and replace conditional with polymorphism.
  • Review & Refactor Checklist: Concrete review checklist and refactoring workflow to apply during pull request reviews, refactors, and bug fixes to keep behavior safe and tests passing.

Quick Start

Ask the skill to review a pull request for naming clarity, long functions, duplicated logic, error handling gaps, and complexity and return prioritized, test-friendly refactoring suggestions.

Frequently Asked Questions about code-quality-standards

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

FAQPage Schema
How do I identify code smells and refactoring opportunities in my source code?

A code review checklist for pull requests should check naming clarity, function size, error handling gaps, and complexity thresholds. Use refactoring workflows to suggest test-friendly improvements while keeping behavior safe and tests passing.

How do I reduce function complexity and long parameter lists during a refactoring task?

To reduce function complexity, apply refactoring patterns like extract method and introduce parameter object to break down long methods. Enforce KISS and DRY principles to simplify logic, eliminate duplicated code, and improve overall readability.

What are the best practices for improving readability and fixing improper error handling?

Best practices for improving readability involve enforcing small functions, clear naming, and immutability. Fix improper error handling by applying pure function principles and utilizing a concrete refactoring checklist to ensure safe behavior during bug fixes.

Does code review for maintainability include security audits or architectural redesigns?

Code review for maintainability explicitly excludes security audits and architectural redesigns. It focuses solely on remediating code quality issues like dead code, feature envy, and high complexity to reduce technical debt without altering system architecture.