find-refactoring

Detects refactoring candidates in codebases and creates prioritized GitHub Issues using ast-grep and jscpd.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/takemo101/compose-workflow --skill find-refactoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-refactoring
Source: https://github.com/takemo101/compose-workflow/tree/main/.pi/skills/find-refactoring
Command: npx skills add https://github.com/takemo101/compose-workflow --skill find-refactoring

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the identification of potential code refactoring candidates within a codebase, prioritizing them, and creating actionable GitHub Issues for developers.

Core Features & Use Cases

  • Automated Code Analysis: Scans code for common anti-patterns, code smells, and duplication.
  • Prioritized Issue Creation: Generates GitHub Issues with clear titles, descriptions, and priority levels (Critical, High, Medium, Low).
  • Use Case: A developer can run this skill on a new feature branch to proactively identify areas needing refactoring before they become technical debt, ensuring code quality and maintainability.

Quick Start

Run the find-refactoring skill on the src directory to find refactoring candidates.

Frequently Asked Questions about find-refactoring

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

FAQPage Schema
How do I find code refactoring candidates and automatically create GitHub Issues?

You can prioritize code smells for refactoring by assigning priority levels (Critical, High, Medium, Low) to detected anti-patterns and checking issue granularity, which this skill automates to ensure efficient task management.

What is the best way to detect code smells and duplication before they become technical debt?

The best way to detect code smells and duplication before they become technical debt is to run static analysis on feature branches, proactively identifying anti-patterns using tools like ast-grep and jscpd to maintain code quality.

How do I use ast-grep and jscpd to scan a src directory for code smells?

Yes, you can use this skill for automated code review by running it to analyze code quality, identify anti-patterns and duplication, and generate actionable GitHub Issues with clear titles, descriptions, and priority levels.

Does this automated code analysis tool check the granularity of the GitHub Issues it creates?

Yes, this automated code analysis tool checks issue granularity during creation to ensure that the generated GitHub Issues for refactoring candidates are appropriately scoped for efficient task management.