code-simplifier_skill

Overview

This skill simplifies and refines TypeScript code for clarity, consistency, and long-term maintainability while preserving exact functionality. It runs automatically after recent edits or when triggered with phrases like "simplify this code" or "refactor for readability." The goal is readable, explicit code that follows project-specific standards and React patterns where applicable.

How this skill works

I inspect only recently modified or touched code and identify opportunities to reduce complexity, remove redundancy, and improve naming without changing behavior. Changes follow the project's conventions: ES modules, sorted imports, use of function declarations, explicit top-level return types, clear Props types for React, and consistent error-handling patterns. I avoid risky transformations and document only significant changes that affect understanding.

When to use it

• Immediately after implementing features to polish and standardize code
• When code reviews flag readability or consistency issues
• Before merging changes to keep the main branch maintainable
• When onboarding contributors to ensure new code matches standards
• To remove accidental complexity introduced during prototyping

Best practices

• Target only files that were recently modified unless broader review is requested
• Prefer explicit, readable constructions over terse one-liners
• Avoid nested ternaries; use if/else or switch for clarity
• Keep single responsibility per function; don’t combine unrelated concerns
• Use well-chosen names and consolidate related logic to reduce cognitive load

Example use cases

• Refactor a newly added utility to remove redundant conditionals and clarify intent
• Adjust a React component to add an explicit Props type and replace arrow functions with function declarations
• Sort and normalize imports after a large refactor to match ES module conventions
• Replace nested ternary expressions with clear if/else chains or a switch statement
• Consolidate duplicated validation logic introduced across several recent commits