clean-code

Enforce pragmatic coding standards with SOLID principles and verification scripts.

1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/statick88/dotfiles --skill clean-code-statick88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/statick88/dotfiles/tree/main/amp/.agents/skills/clean-code
Command: npx skills add https://github.com/statick88/dotfiles --skill clean-code-statick88

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enforces pragmatic coding standards to ensure code is simple, direct, and avoids unnecessary complexity, leading to more maintainable and understandable software.

Core Features & Use Cases

  • Enforces SOLID principles: Promotes Single Responsibility, DRY, KISS, YAGNI.
  • Clear Naming Conventions: Guides developers on naming variables, functions, and constants for better readability.
  • Function & Code Structure Guidelines: Provides rules for function size, arguments, and code organization (e.g., guard clauses, flat structure).
  • AI Coding Style: Directs AI agents on how to respond to user requests (write directly, fix bugs, ask when unsure).
  • Pre-edit Checks: Mandates thinking about dependencies and impact before modifying files.
  • Self-Verification: Requires agents to perform mandatory checks before task completion.
  • Script Execution: Defines specific scripts for various validation checks (linting, testing, security, etc.) and mandates their correct usage and output handling.

Quick Start

Follow the core principles and naming rules to write clean, maintainable code.

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 when using AI for coding?

Clean code standards for AI agents are enforced by applying SOLID principles, DRY, KISS, and YAGNI. This skill provides strict rules for naming, function design, and code structure to ensure AI generates concise, maintainable code without over-engineering.

What are the best practices for function design and code structure?

Best practices for function design involve keeping functions small, limiting arguments, and using guard clauses for a flat code structure. Clear naming conventions for variables and functions are also essential for readability and code maintainability.

How can I prevent over-engineering in software development?

Prevent over-engineering by adhering to the KISS and YAGNI principles. This approach focuses on writing direct, simple code that avoids unnecessary complexity, ensuring your software remains highly maintainable and easy to understand.

Does this clean code skill require any specific dependencies or testing scripts?

This clean code skill has no external dependencies. It includes scripts and references to define specific validation checks like linting, testing, and security, mandating their correct usage and output handling for agent self-verification.

How do AI agents handle pre-edit checks and self-verification?

AI agents handle pre-edit checks by thinking about dependencies and impact before modifying files. For self-verification, agents must perform mandatory checks before task completion, running specific validation scripts to ensure code quality.