clean-code

Guide code changes toward concise, maintainable implementations with dependency impact checks.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/capaas2/Site-teste --skill clean-code-capaas2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/capaas2/Site-teste/tree/main/.agent/skills/clean-code
Command: npx skills add https://github.com/capaas2/Site-teste --skill clean-code-capaas2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers make safer, simpler code changes without over-engineering, unnecessary comments, or broken dependencies.

Core Features & Use Cases

  • Pragmatic Refactoring: Applies SRP, DRY, KISS, and YAGNI to keep code small and maintainable.
  • Change Impact Awareness: Reminds you to check imports, dependents, tests, and shared components before editing.
  • Verification Discipline: Reinforces self-checks and validation so changes are complete and do not leave the project in a broken state.
  • Use Case: A developer needs to fix a bug in a shared service and wants a concise, reliable approach that updates all affected files and validates the result.

Quick Start

Use the clean-code skill to review this change for simplicity, dependency impact, and whether all affected files and tests are updated.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor code in a shared codebase without breaking dependencies?

To refactor code without breaking dependencies, you must check imports, dependents, tests, and shared components before editing. This ensures changes remain dependency-safe and prevents leaving the project in a broken state during software engineering tasks.

What is clean code and how does it apply to bug fixes?

Clean code applies pragmatic standards like SRP, DRY, KISS, and YAGNI to bug fixes, ensuring implementations stay concise and maintainable. It reinforces validation checks and completion discipline to ship reliable software engineering changes.

How do I add a feature to a shared service without over-engineering?

Adding a feature without over-engineering requires applying clean architecture principles and avoiding unnecessary comments. You must perform validation checks and update all affected files to ensure the feature addition is complete and maintainable.

Does this clean code approach work for dependency-safe file edits?

Yes, this approach works for dependency-safe file edits by enforcing strong change-impact awareness. It requires checking imports and shared components before editing, ensuring the codebase maintains integrity during refactoring or feature additions.

What is the best way to review code changes for maintainability?

The best way to review code changes for maintainability is to apply SRP, DRY, KISS, and YAGNI principles while verifying that all affected files and tests are updated. This reinforces self-checks to prevent broken project states.

When should I not use over-engineering in software engineering tasks?

You should avoid over-engineering in software engineering tasks when concise, maintainable implementations are sufficient. Applying pragmatic standards like KISS and YAGNI prevents unnecessary complexity during bug fixes and refactoring.