clean-code

Enforce pragmatic coding standards for naming, structure, and minimalism.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/BeastAyyG/Campus-Cupids --skill clean-code-beastayyg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/BeastAyyG/Campus-Cupids/tree/main/.agent_backup/skills/clean-code
Command: npx skills add https://github.com/BeastAyyG/Campus-Cupids --skill clean-code-beastayyg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pragmatic AI coding standards help developers write clean, maintainable code by avoiding unnecessary complexity, noisy comments, and over-engineering.

Core Features & Use Cases

  • Clear naming conventions (variables, functions, constants) that reveal intent.
  • Guidelines for function size, guard clauses, and minimizing nesting to improve readability and maintainability.
  • Anti-patterns to avoid and a simple, repeatable workflow for safer code evolution.

Quick Start

Audit a module for SRP, DRY, and KISS violations and refactor into smaller, well-named units with minimal comments.

Frequently Asked Questions about clean-code

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

FAQPage Schema
What are guard clauses and how do they improve code readability?

Guard clauses are early returns that handle edge cases upfront to minimize nesting. They improve code readability by flattening conditional logic, making the main execution flow immediately clear without deep indentation.

How do I refactor a module to fix SRP and DRY violations?

To refactor a module for SRP and DRY violations, audit the code to identify overlapping responsibilities and duplicated logic. Extract these into smaller, well-named functions that each handle a single concern to improve maintainability.

What is the best way to enforce naming conventions for variables and functions?

The best way to enforce naming conventions is to apply standards that reveal intent, ensuring variables, functions, and constants clearly describe their purpose. This pragmatic approach eliminates ambiguity and reduces the need for noisy comments.

Can I use these clean code standards to reduce over-engineering in my project?

Yes, you can use these clean code standards to reduce over-engineering. They enforce minimalism, small functions, and anti-pattern avoidance, guiding developers to write maintainable code without unnecessary complexity.

When should I avoid adding comments to improve code maintainability?

You should avoid adding comments when the code itself can be made self-documenting through clear naming conventions and minimal structure. Noisy comments often compensate for poor readability rather than adding genuine value.

Why does minimizing nesting help with code quality?

Minimizing nesting helps code quality by reducing cognitive load. By enforcing guardrails for small functions and early returns, developers avoid deeply nested conditionals, resulting in simpler and more reliable code evolution.