clean-code

Enforce clean coding standards and refactoring heuristics during code review.

2|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/eng-vmessiah/project-development-skill --skill clean-code-eng-vmessiah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/eng-vmessiah/project-development-skill/tree/main/skills/clean-code
Command: npx skills add https://github.com/eng-vmessiah/project-development-skill --skill clean-code-eng-vmessiah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the accumulation of technical debt and poor readability by providing a structured framework for writing, reviewing, and refactoring code to ensure it remains maintainable and orderly.

Core Features & Use Cases

  • Naming & Structure: Provides concrete rules for intention-revealing names and function design (Small, Do One Thing, One Level of Abstraction).
  • Quality Assurance: Offers checklists for error handling, unit testing (F.I.R.S.T. principles), and class cohesion (SRP).
  • Use Case: Use this skill during a code review to identify anti-patterns like magic numbers, feature envy, or excessive function arguments, and apply the provided refactoring heuristics to improve the codebase.

Quick Start

Use the clean-code skill to analyze the current module for naming inconsistencies and violations of the single responsibility principle.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I identify and fix clean code violations during a code review?

To enforce clean coding standards during code review, check for anti-patterns like magic numbers, feature envy, or excessive function arguments, then apply refactoring heuristics to improve readability and maintainability.

What are the rules for intention-revealing names and function design?

Intention-revealing names and function design require writing small functions that do one thing at a single level of abstraction, ensuring code structure remains orderly and readable.

How do I reduce technical debt when refactoring a legacy system?

Refactoring a legacy system to reduce technical debt involves enforcing clean coding standards, applying SOLID design principles, and improving class cohesion through the single responsibility principle.

Does this clean code framework support unit testing and error handling checks?

Yes, the clean code framework provides quality assurance checklists for error handling and unit testing based on the F.I.R.S.T. principles to ensure software testability and code quality.

What is the best way to analyze a module for single responsibility principle violations?

The best way to analyze a module for single responsibility principle violations is to use a clean code skill to detect naming inconsistencies and poor class cohesion, then apply structured refactoring heuristics.

When should I apply SOLID design principles to new feature development?

Apply SOLID design principles during new feature development whenever requirements for readability, testability, and maintainability must be satisfied to prevent accumulating technical debt.