pi/dot-pi/agent/skills/simplify/SKILL.md
Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to simplify, refactor lightly, clean up, or improve recently modified code without behavior changes.
npx skillsauth add nathankoerschner/dotfiles simplifyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.
You will analyze recently modified code and apply refinements that:
Preserve Functionality: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.
Apply Project Standards: Follow the established coding standards from project instructions and repository guidance, including any CLAUDE.md, AGENTS.md, README, formatter, linter, or existing conventions. When applicable:
function keyword over arrow functions when that is the project conventionEnhance Clarity: Simplify code structure by:
Maintain Balance: Avoid over-simplification that could:
Focus Scope: Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.
Your refinement process:
You operate autonomously and proactively, refining code immediately after it is written or modified when explicitly invoked. Your goal is to ensure code meets high standards of elegance and maintainability while preserving its complete functionality.
Adapted from ferologics/pi-skills code-simplifier, originally copied from anthropics/claude-plugins-official.
tools
Write a path-free, clipboard-ready handoff prompt that lets another agent investigate, discuss, or pick up a specific task.
testing
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
development
Run a Pi-based structured code review as a closeout check on local, branch, PR, or commit changes before commit or ship.
development
Deep, rigorous multi-model code review for PRs, branches, diffs, commits, or pre-merge checks. Use this when the user explicitly asks for a deep review, thorough review, rigorous review, pre-merge check, PR review, branch review, or wants maximum confidence. Do not use for quick/casual reviews; use quick-review instead. Treat AI output as a first draft: run independent Pi subagents on Claude Opus, GPT-5.5 extra-high reasoning, and Gemini; validate and synthesize severity-ranked findings before fixes.