Can it handle large-scale refactoring across multiple files?

Yes. The skill can delegate analysis to sub-agents that run in parallel, allowing it to audit and improve entire directories or modules simultaneously.

Can I use this on auto-generated code?

It is not recommended. The skill is designed for human-maintained code; refactoring auto-generated files can lead to conflicts when the code is next regenerated.

How does it decide when to inline a function?

It targets 'forwarding' functions that merely pass data to another layer without adding logic, as these often create unnecessary call depth and mental overhead.

Will this skill change how my code functions?

No. This skill focuses strictly on refactoring—improving the internal structure and readability of the code without changing its external behavior or logic.

What programming languages are supported?

While the skill includes a specific sub-agent for Go style reviews, the core readability improvements like inlining, renaming, and structural simplification are applicable to all major programming languages.

Code Readability Improver

Name: Code Readability Improver
Author: futuretea

byfuturetea

0•

開発者ツール

Refactors code to enhance clarity, reduce unnecessary abstraction, and optimize structural locality for better human comprehension.

The Code Readability Improver is a specialized skill designed to eliminate cognitive load in complex codebases. It systematically analyzes function call depth, naming quality, and structural locality to identify areas where abstraction hinders understanding. By inlining redundant 'pass-through' functions, improving semantic naming, and consolidating fragmented logic, this skill transforms dense, layered code into clear and maintainable modules. It features parallel processing for multi-file analysis and includes specialized support for Go style conventions, making it an essential tool for technical debt reduction and code review preparation.

主な機能

01Automated inlining of single-purpose forwarding functions and wrappers

02Parallel multi-file and multi-module refactoring capabilities

03Integrated Go style review for idiomatic code improvements

04Intelligent renaming of variables and functions for semantic clarity

050 GitHub stars

06Systematic analysis of function call depth and structural locality

ユースケース

01Simplifying deeply nested function calls and excessive layers of abstraction

02Refactoring legacy code where original intent has become obscured by poor naming

03Conducting comprehensive code quality audits across entire directories or packages

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add futuretea/code-assistant readability-improvement

For use in Claude.ai and ChatGPT

Download Skill