clean-code

Apply universal clean-code principles to refactor and improve code quality.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing clear, maintainable code is essential to long-term project health. This skill codifies universal practices that improve readability, reduce defects, and simplify future changes across languages and frameworks.

Core Features & Use Cases

  • Naming conventions that communicate intent and reduce ambiguity.
  • Function design that favors single responsibility and clear abstractions.
  • Structural organization that minimizes duplication and promotes readability.
  • Guidance on avoiding common code smells and promoting maintainability across modules.
  • Use Case: refactor a legacy module to improve clarity and reduce cognitive load for future contributors.

Quick Start

Explain and apply clean-code principles to your current project and refactor one module following these guidelines.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor legacy code to improve readability and maintainability?

Apply universal clean-code principles to refactor legacy modules, enforcing naming clarity, single-responsibility functions, and minimal side effects to improve readability and reduce cognitive load across languages.

What are common code smells and how do I structure functions to avoid them?

Avoid common code smells like duplication and ambiguous abstractions by designing functions with single responsibility and clear abstractions, promoting maintainability and reducing defects across project modules.

Can I apply clean-code principles across different programming languages and frameworks?

Apply clean-code principles across any programming language or framework. The rules enforce naming clarity, structural organization, and minimal side effects without tying to a specific language.

What is the best way to name variables and functions to communicate intent?

Use naming conventions that reduce ambiguity to communicate intent. Apply clean-code rules to ensure naming clarity across modules, making the codebase reliable and easier to maintain.