clean-code

Audit and refactor existing code for readability without changing behavior.

14|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/hungv47/meta-skills --skill clean-code-hungv47
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/hungv47/meta-skills/tree/main/forsvn-dev/skills/product/clean-code
Command: npx skills add https://github.com/hungv47/meta-skills --skill clean-code-hungv47

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits and refactors existing code for readability, maintainability, and dead code removal without changing behavior.

Core Features & Use Cases

  • In-place code cleanup that preserves runtime behavior
  • Elimination of dead code and simplification of complex constructs
  • Produces a dated artifact record at docs/forsvn/artifacts/meta/records/[date]-cleanup-<slug>.md

Quick Start

Run the cleanup on a target file or directory to begin safe code improvements.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I refactor existing code for readability without changing runtime behavior?

Code refactoring for readability without changing behavior is done through in-place fixes that preserve runtime logic while simplifying constructs and eliminating dead code. It targets files across languages and safely records the work in a dated cleanup artifact for rollback support.

What is the best way to remove dead code and maintain code readability?

Dead code removal and readability maintenance are best handled by auditing existing code and applying safe-change practices. It eliminates unused constructs in-place across the repository and logs every change in a dated markdown record under the artifacts directory.

How do I perform a code cleanup that supports audits and rollback?

Code cleanup that supports audits and rollback requires producing a dated artifact record at docs/forsvn/artifacts/meta/records/[date]-cleanup-<slug>.md. It enforces safe-change practices during refactoring to ensure all readability improvements can be reviewed and reversed if needed.

Can I use this code refactoring approach across different programming languages in my repository?

Code refactoring with this approach targets in-place fixes across languages in the repository. It audits and refactors existing code for readability and maintainability regardless of the specific programming language used in the target files.

When do I need to create a cleanup artifact for code refactoring?

A cleanup artifact for code refactoring is needed when you apply in-place readability fixes and want to support audits or rollback. It records the refactoring work in a dated markdown file under docs/forsvn/artifacts/meta/records/ to maintain a history of safe changes.

Why should I preserve runtime behavior during a code cleanup?

Preserving runtime behavior during code cleanup ensures that readability improvements and dead code elimination do not introduce functional regressions. It enforces safe-change practices so the refactored code remains operationally identical while becoming easier to maintain.