skills.rest
jdeweedata
jdeweedataCOMMUNITY
Explore all skills by this author →
GitHub

Refactor Agent

Identify and prioritize code quality issues in TypeScript/Next.js projects.

1|Updated May 5, 2025
Search Tags:#code quality#architecture#code review#technical debt#pattern recognition#refactor#analyze
One-click install
npx skills add https://github.com/jdeweedata/circletel --skill refactor-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Refactor Agent
Source: https://github.com/jdeweedata/circletel/tree/main/.claude/skills/refactor
Command: npx skills add https://github.com/jdeweedata/circletel --skill refactor-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineering teams quickly identify technical debt, performance bottlenecks, and architectural weaknesses in a codebase, providing prioritized, actionable refactoring recommendations to improve maintainability and delivery velocity.

Core Features & Use Cases

  • Structural Scan: Maps architecture, boundaries, and dependencies to reveal coupling and ownership gaps.
  • Pattern Recognition: Detects recurring anti-patterns, duplication, and complexity hotspots to prioritize fixes.
  • Impact & Dependency Analysis: Assesses blast radius, touch frequency, and effort to guide safe, targeted refactors.
  • Use Case: Before a major feature rollout or tech debt sprint, generate a concrete plan outlining high-impact changes and estimated effort.

Quick Start

Run the Refactor Agent on a codebase to surface high-leverage refactoring opportunities and produce a prioritized plan for improving structure and maintainability.

Frequently Asked Questions about Refactor Agent

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

FAQPage Schema
How do I identify and prioritize technical debt in a large TypeScript codebase?▼

To identify technical debt in a TypeScript codebase, this Skill maps architecture and detects complexity hotspots using pattern recognition. It prioritizes refactoring opportunities by assessing blast radius and touch frequency to guide safe, targeted fixes.

What is the best way to plan a pre-feature code cleanup for Next.js 15 projects?▼

Planning a pre-feature code cleanup for Next.js projects requires assessing architectural weaknesses and dependency coupling. This Skill generates a prioritized refactoring plan with effort estimates, aligning changes with TS strictness and safe refactoring patterns.

How do I analyze code quality issues to guide targeted refactoring?▼

Analyzing code quality to guide refactoring involves scanning for recurring anti-patterns and duplication. This Skill performs structural scans to reveal ownership gaps and provides actionable recommendations to improve maintainability and delivery velocity.

Can I use this to estimate effort for refactoring complex code before a sprint?▼

Yes, you can estimate refactoring effort before a sprint. This Skill evaluates dependency analysis and impact to calculate the blast radius of changes, providing concrete effort estimates for high-leverage refactoring opportunities.

When should I scan for anti-patterns and duplication during ongoing maintenance?▼

You should scan for anti-patterns and duplication during ongoing maintenance when delivery velocity slows. This Skill detects recurring complexity hotspots and architectural weaknesses, producing a targeted plan to preserve behavior while resolving structural issues.

Related Skills

Explore More Software Engineering Skills→
korchasakorchasa
3

flow-setup-agent-code-style-ts-strict

Inject TypeScript strict mode code style rules into AGENTS.md files.

Community
Basic
rsmdtrsmdt
381

refactoring-methodology

Plan staged code refactorings with baseline tests and behavior preservation.

Community
Advanced
winsorllcwinsorllc

code-review

Execute linters, static analysis, and security scanners on code.

Community
Intermediate
santosomarsantosomar
1

technical-debt-analyzer

Analyze codebases to quantify and prioritize technical debt hotspots.

Community
Intermediate