refactoring-discovery

Identify refactoring opportunities in TypeScript codebases via metrics-driven analysis.

1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/CAPHTECH/claude-marketplace --skill refactoring-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactoring-discovery
Source: https://github.com/CAPHTECH/claude-marketplace/tree/main/caphtech-plugin/skills/refactoring-discovery
Command: npx skills add https://github.com/CAPHTECH/claude-marketplace --skill refactoring-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) and scripts (resource) components.

What problem does it solve?

Auto-discovers design smells, coupling, and SOLID violations to inform targeted refactoring.

Core Features & Use Cases

  • Module-by-module health checks
  • Markdown report and Refactoring Plan templates
  • Metrics dashboards for code health

Quick Start

Run a project-wide scan to generate a discovery report with recommended refactorings.

Frequently Asked Questions about refactoring-discovery

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

FAQPage Schema
How do I identify refactoring opportunities in my TypeScript codebase?

Refactoring discovery analyzes TypeScript projects to auto-detect design smells, excessive responsibilities, and SOLID violations. Run a project-wide scan to generate a Markdown report with prioritized refactoring recommendations and metrics.

What code quality metrics does static analysis reveal?

Static analysis metrics quantify coupling, cohesion, and module health across your codebase. The Skill produces dashboards and reports showing which files and modules violate design standards, enabling targeted improvements.

Can I run refactoring analysis on specific directories or files?

Yes, the Skill supports project-wide, directory-level, and file-level scopes. Choose the granularity that fits your workflow—periodic audits, pre-feature reviews, or root-cause investigations of specific components.

How does this help enforce SOLID principles in TypeScript?

The Skill detects violations of SOLID design principles—single responsibility, loose coupling, high cohesion—and reports them with refactoring plans. Use results to guide code restructuring and validate design standards compliance.

What output formats does the refactoring analysis produce?

Analysis outputs Markdown reports, refactoring plans, and a metrics dashboard. These deliverables summarize design smells, coupling issues, and recommended actions for stakeholder communication and implementation tracking.

When should I run refactoring discovery in my development workflow?

Run discovery for on-demand analysis when investigating code quality concerns, periodic audits during planning cycles, or pre-feature reviews to assess technical debt before new development.