improvement-discovery

Codifies smell taxonomy, analysis workflow, and prioritization to identify architectural hotspots and refactoring targets for packages.

143|52|Updated May 15, 2026
One-click install
npx skills add https://github.com/gotgenes/pi-packages --skill improvement-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improvement-discovery
Source: https://github.com/gotgenes/pi-packages/tree/main/.pi/skills/improvement-discovery
Command: npx skills add https://github.com/gotgenes/pi-packages --skill improvement-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Discovering structural improvements across a package can be ad hoc and error-prone. This skill codifies a smell taxonomy, an analysis workflow, and a prioritization framework to guide systematic refactoring during improvement rounds.

Core Features & Use Cases

  • Smell taxonomy for architectural health and hotspots.
  • Analysis workflow from initial data gathering to targeted improvement targets.
  • Prioritization framework to group fixes into achievable steps and tracks.

Quick Start

Plan your next improvement round by reviewing the taxonomy, running fallow health checks, and prioritizing hotspots in the architecture docs.

Frequently Asked Questions about improvement-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify and prioritize code smells for refactoring?

To identify and prioritize code smells for refactoring, apply a structured smell taxonomy and prioritization framework to group architectural hotspots into achievable steps and tracks during improvement rounds.

What is the best way to plan repository-level architecture improvements?

The best way to plan repository-level architecture improvements is codifying a repeatable analysis workflow that surfaces hotspots and prioritized refactoring targets across the entire package.

How do I create a repeatable workflow for discovering structural improvements?

Create a repeatable workflow for discovering structural improvements by codifying a smell taxonomy, an analysis workflow, and a prioritization framework to guide systematic refactoring instead of relying on ad hoc checks.

Can I use a prioritization framework to group refactoring targets into tracks?

Yes, you can use a prioritization framework to group refactoring targets into achievable steps and tracks, driving planning and execution for your improvement rounds.

When do I need a smell taxonomy for architectural health checks?

You need a smell taxonomy for architectural health checks when discovering structural improvements across a package becomes too ad hoc and error-prone, requiring systematic hotspot identification.