code-polisher

Refactor code to improve readability and maintainability across languages.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/k1lgor/virtual-company --skill code-polisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-polisher
Source: https://github.com/k1lgor/virtual-company/tree/main/skills/04-code-polisher
Command: npx skills add https://github.com/k1lgor/virtual-company --skill code-polisher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you improve maintainability, readability, and performance by guiding targeted refactors.

Core Features & Use Cases

  • Improve variable and function names to be self-describing.
  • Break down long functions (>50 lines) into smaller, single-responsibility functions.
  • Remove dead code or commented-out logic.
  • Apply DRY, SOLID principles, and ensure modern syntax usage across the detected language.
  • Provide a concise summary of changes and the refactored code.

Quick Start

Refactor this function to improve readability and performance.

Frequently Asked Questions about code-polisher

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

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

To refactor code for readability and maintainability, you improve variable and function names to be self-describing, break down long functions exceeding 50 lines into smaller single-responsibility units, and remove dead code or commented-out logic. Applying DRY and SOLID principles ensures safe, incremental structural improvements across your codebase.

When do I need to refactor a function for better code quality?

You need to refactor a function for better code quality when it exceeds 50 lines, lacks self-describing naming, contains commented-out logic, or violates DRY and SOLID principles. Safe, incremental changes enforce modern syntax usage and improve overall codebase performance and maintainability.

What is the best way to apply SOLID and DRY principles during a code refactor?

The best way to apply SOLID and DRY principles during a code refactor is to break down long functions into smaller, single-responsibility units and remove dead code. This approach enforces modern syntax usage while focusing on safe, incremental changes across the detected language.

Can I refactor an entire codebase across different programming languages?

Yes, you can refactor an entire codebase across different programming languages. The refactoring process applies to functions, modules, or entire codebases across languages for naming, structure, and performance improvements while ensuring modern syntax usage is applied consistently.

Why does my code refactor break when applying large structural changes?

Your code refactor may break when applying large structural changes because safe refactoring requires incremental changes. Breaking down long functions into smaller single-responsibility units and removing dead code incrementally prevents breaking existing logic and maintains overall codebase stability.