simplify
Simplifies and refines modified code to improve readability without altering function.
Install
mkdir -p .claude/skills/simplify-bebraw && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12773" && unzip -o skill.zip -d .claude/skills/simplify-bebraw && rm skill.zipInstalls to .claude/skills/simplify-bebraw
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.Key capabilities
- →Shorten verbose names
- →Merge redundant types or constants
- →Remove derivable state
- →Refine recently modified code
- →Improve readability without changing functionality
How it works
This skill analyzes modified code to shorten names, merge related concepts, and remove derivable state, aiming to improve readability without altering functionality.
Inputs & outputs
When to use simplify
- →Clean up code after a feature implementation
- →Simplify complex type definitions
- →Refactor variable names for clarity
About this skill
Review changes in the current branch, or in the state the user specifies. Apply these criteria without changing behavior:
-
Names: Shorten verbose names while keeping them clear. Prefer human-readable concepts (
baseline) over compound phrases that are more mechanical / academic (lastObservedDiskContent). -
Combine related concepts: If two types, functions, or constants overlap significantly, merge them. The fewer distinct concepts a reader must hold in their head, the better. Example: two union types sharing 3 of 4 values → one type with shorter value names.
-
Derivability: If a value can be computed from other values already in scope, don't pass or store it separately. Removing derivable state often simplifies signatures, types, and control flow in one move. Example: an
isDirtyparameter that's always derived from computingeditorContent !== baselinecan be dropped. -
Scope: Only touch code in the specified scope. Validate your work does not break existing functionality.
When not to use it
- →When the task involves changing functionality
- →When the task is outside the specified scope
Limitations
- →It must not change functionality
- →It only touches code within the specified scope
- →It focuses on readability and consistency
How it compares
This skill provides a specific set of criteria for code simplification, focusing on clarity and consistency post-implementation, rather than general refactoring or feature development.
Compared to similar skills
simplify side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| simplify (this skill) | 0 | 4mo | No flags | Intermediate |
| when-stuck-problem-solving-dispatch | 8 | 9mo | No flags | Beginner |
| agent-refinement | 1 | 6mo | Review | Advanced |
| ponytail | 0 | 1mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by bebraw
View all by bebraw →You might also like
when-stuck-problem-solving-dispatch
mrgoonie
Dispatch to the right problem-solving technique based on how you're stuck
agent-refinement
ruvnet
Agent skill for refinement - invoke with $agent-refinement
ponytail
s0r4n9n
>
ssotize
LowyShin
Consolidate a fact that's scattered across places into one canonical source and replace the rest with references — mutating. Use when the user asks to deduplicate, consolidate, unify, or establish a single source of truth across artifacts or platforms; or when the same fact lives in many places and
repository-cleanup-campaign
AriusII
Plan and execute broad workspace cleanup campaigns when repository cleanup hygiene campaign or many warnings keywords appear.
software-architecture
davila7
Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development.