wiggum-refactor

Analyze code modules to identify patterns, spec deviations, and simplification opportunities.

45|7|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/wiggum-cc/chief-wiggum --skill wiggum-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiggum-refactor
Source: https://github.com/wiggum-cc/chief-wiggum/tree/main/skills/wiggum-refactor
Command: npx skills add https://github.com/wiggum-cc/chief-wiggum --skill wiggum-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The wiggum-refactor skill performs post-hoc analysis of modules after multiple PRs to identify reusable patterns, reveal spec deviations, and suggest simplifications to reduce technical debt.

Core Features & Use Cases

  • Pattern extraction: Identify recurring structures and conventions that can generalize into a spec or library.
  • Deviation detection: Compare implementation against authoritative specs and highlight mismatches with concrete file:line citations.
  • Simplification guidance: Propose restructuring or consolidation to improve maintainability and readability.
  • Use Case: After a feature has touched the same module across many PRs, run refactor analysis to surface patterns to standardize in the Kanban backlog.

Quick Start

Run the skill on a target module path, for example: wiggum-refactor lib/my-service/

Frequently Asked Questions about wiggum-refactor

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

FAQPage Schema
How do I identify refactoring opportunities to reduce technical debt after multiple PRs?

To reduce technical debt after multiple PRs, run a post-hoc module analysis to identify recurring patterns, spec deviations, and simplification opportunities. This process surfaces prioritized refactoring recommendations grounded with file:line citations and authoritative spec references.

What is the best way to detect code deviations from an authoritative spec?

The best way to detect code deviations is to perform an analysis that compares your implementation against authoritative specs. This highlights mismatches with concrete file:line citations, revealing exactly where the code diverges from the intended standard.

How do I extract reusable code patterns for a Kanban backlog?

You can extract reusable code patterns by analyzing modules to identify recurring structures and conventions. This analysis suggests consolidations to standardize in a library or spec, and can optionally create Kanban tasks to track the work.

When should I run a code simplification analysis on my modules?

You should run a code simplification analysis during cleanup cycles or after a feature has touched the same module across multiple PRs. This timing ensures accumulated technical debt and structural inconsistencies are addressed before they compound.

Can I generate Kanban tasks directly from technical debt analysis?

Yes, you can generate Kanban tasks directly from technical debt analysis. The analysis produces prioritized refactoring recommendations with evidence, and includes optional Kanban task creation to track the identified simplification work.