refactor

Coordinate refactor sub-skills to audit code quality and generate a Markdown report.

6|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/JordanGunn/skills --skill refactor-jordangunn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/JordanGunn/skills/tree/main/skills/refactor
Command: npx skills add https://github.com/JordanGunn/skills --skill refactor-jordangunn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Coordinates multi-skill audits to ensure consistent, minimal-risk code-quality improvements across a codebase.

Core Features & Use Cases

  • Orchestrates the eight refactor sub-skills (dictionaries, inline-complexity, lexical-ontology, import-hygiene, module-stutter, semantic-noise, squatters, structural-duplication) to produce a unified report and staged remediation plan.
  • Generates a consolidated Markdown report with grouped findings, severity levels, and recommended actions.
  • Supports staged refactor planning by delegating to member skills while preserving domain boundaries.

Quick Start

Run the orchestrator on a target repository to trigger the end-to-end refactor audit pipeline and obtain a single, actionable report.

Frequently Asked Questions about refactor

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

FAQPage Schema
How do I run an automated code-quality audit across an entire repository?

To run a code-quality audit, you apply an orchestrator to the repository or directory subtree to trigger an end-to-end audit pipeline and obtain a single Markdown report with findings grouped by severity.

What is the best way to coordinate multiple refactor checks across different modules?

Coordinating refactor checks requires an orchestrator that delegates to specialized sub-skills, preserving domain boundaries while producing a unified report and a structured refactor plan template for safe, incremental changes.

Can I generate a staged remediation plan for complex codebases?

You can generate a staged remediation plan by running the orchestrator on a target repository, which delegates to member skills and produces a structured template for safe, incremental changes across multiple domains.

Does the refactor audit pipeline require any external dependencies or tools?

The refactor audit pipeline operates with no external dependencies, using built-in sub-skills to audit areas like import-hygiene, structural-duplication, and lexical-ontology directly within the workflow.

What specific code-quality domains are covered by the audit sub-skills?

The audit covers eight specific domains: dictionaries, inline-complexity, lexical-ontology, import-hygiene, module-stutter, semantic-noise, squatters, and structural-duplication.

When should I avoid using a multi-skill orchestrator for code remediation?

You should avoid using a multi-skill orchestrator when you only need a single-domain check, because this tool is designed to coordinate end-to-end audits and produce a consolidated report across multiple modules.