clean-code

Enforce pragmatic coding standards for AI-assisted development with verification scripts.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/mbeps/Skills --skill clean-code-mbeps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/mbeps/Skills/tree/main/clean-code
Command: npx skills add https://github.com/mbeps/Skills --skill clean-code-mbeps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers write more maintainable, readable, and efficient code by adhering to established best practices and avoiding common pitfalls.

Core Features & Use Cases

  • Coding Standards: Enforces principles like SRP, DRY, KISS, and YAGNI.
  • Naming Conventions: Guides on clear and intent-revealing names for variables, functions, and constants.
  • Code Structure: Promotes guard clauses, flat code, and composition over deep nesting.
  • AI Coding Style: Directs AI behavior for feature implementation, bug fixing, and requirement clarification.
  • Verification Scripts: Integrates automated checks for linting, type coverage, and more.

Quick Start

Apply the clean-code skill to refactor the provided code snippet for improved readability and maintainability.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I enforce clean code standards during AI-assisted development?

To enforce clean code standards during AI-assisted development, apply this Skill to guide naming conventions, function design, and code structure, ensuring AI-generated code remains concise, direct, and maintainable.

What are the best practices for refactoring code to improve maintainability?

Best practices for refactoring code to improve maintainability involve enforcing principles like SRP, DRY, KISS, and YAGNI, while restructuring deep nesting into flat code using guard clauses and composition.

How do I prevent AI from over-engineering code features?

To prevent AI from over-engineering code features, this Skill enforces pragmatic coding standards that direct AI behavior toward conciseness, directness, and avoiding unnecessary complexity during feature implementation.

Can I automate code quality checks for readability and structure?

Yes, you can automate code quality checks for readability and structure using the integrated verification scripts, which perform mandatory self-checks for linting, type coverage, and overall quality assurance.

Does this approach to coding standards work for existing codebases?

Yes, this approach to coding standards works for existing codebases by applying the Skill to refactor provided code snippets, improving their readability and maintainability according to established best practices.