@firstpick/pi-skill-refactoring-advisor

Agents should invoke this skill for refactors, code smells, migrations, duplication removal, module splitting, API cleanup, or restructuring plans. Emphasizes small safe steps, behavior preservation, and verification after each change.

Packages

Package details

skill

Install @firstpick/pi-skill-refactoring-advisor from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@firstpick/pi-skill-refactoring-advisor
Package
@firstpick/pi-skill-refactoring-advisor
Version
0.1.5
Published
Aug 7, 2026
Downloads
417/mo · 28/wk
Author
firstpick
License
MIT
Types
skill
Size
9.9 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Refactoring Advisor

Improve difficult code through small steps while keeping its behavior the same.

Helpful when

  • A file or module has become too large.
  • Changes are risky because responsibilities are mixed together.
  • You want a cleanup plan before editing code.

What to share with Pi

  • The code or area that is hard to maintain
  • Behavior that must not change
  • Available tests and time constraints

Try asking

Plan a small, safe refactor for this module. Keep behavior unchanged and show the checks needed after each step.

What you’ll get

  • The main maintenance problems
  • A sequence of small changes
  • Tests, checkpoints, and rollback options

Keep in mind

Refactoring should not quietly add features or change behavior. Any such choice should be handled separately.

Install

pi install npm:@firstpick/pi-skill-refactoring-advisor

Restart Pi if the skill does not appear in your current session.

Technical details

See TECHNICAL.md for advanced usage, configuration, compatibility, and limitations.