busirocket/agents-skills/busirocket-refactor-workflow

Claude Code and agent skill by busirocket/agents-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Enforces strict refactoring workflow for TypeScript/React codebases. Use when refactoring files with multiple exports, splitting components/hooks/utils, moving inline types to types/, and enforcing post-refactor quality gates.

Install

npx vskill@latest install busirocket/agents-skills/busirocket-refactor-workflow

SKILL.md

Refactor Workflow

Strict, step-by-step refactoring guidance for maintaining code quality.

When to Use

Use this skill when:

  • Refactoring files with multiple exports (use @file workflow)
  • Splitting components/hooks/utils into smaller files
  • Moving inline types to types/
  • Enforcing post-refactor quality checks

Non-Negotiables (MUST)

  • After any refactor: run the project's standard checks (e.g. yarn check:all)

as a mandatory quality gate.

  • If a file has multiple responsibilities, split immediately.
  • If a hook/component contains helpers, extract them.
  • If a file declares types inline, move them to types/.
  • Never use index/barrel files; import from concrete modules only.

@file Refactor Workflow

When referencing @file for a one-shot refactor:

  • Exactly one exported symbol per file.
  • No inline interface/type declarations in non-type files.
  • No helper functions inside components/hooks.

Rules

@file Refactor Workflow
  • refactor-file-workflow - @file refactor workflow (strict constraints)
  • refactor-mandatory-checks - Mandatory checks after refactor
Refactoring TypeScript/React
  • refactor-goals - Goals for refactoring (many small files, one export per

file)

  • refactor-decision-rules - Decision rules for when to split files
  • refactor-never-index-files - Never use index files
  • refactor-post-refactor-checks - Post-refactor checks (MANDATORY)
Post-Refactor Checks
  • refactor-golden-path - Golden path for post-refactor checks
  • refactor-file-size-guidelines - File size targets and max lines
  • refactor-if-something-fails - What to do if checks fail
  • refactor-when-to-split - Fast heuristics for when to split files

Related Skills

  • busirocket-core-conventions - File structure and boundaries
  • busirocket-typescript-standards - TypeScript standards to enforce
  • busirocket-react - Component/hook patterns

How to Use

Read individual rule files for detailed explanations and code examples:

rules/refactor-file-workflow.md
rules/refactor-decision-rules.md
rules/refactor-post-refactor-checks.md

Each rule file contains:

  • Brief explanation of why it matters
  • Code examples (correct and incorrect patterns)
  • Additional context and best practices

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Refreshed 17 Mar 2026, 8 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/busirocket/agents-skills/busirocket-refactor-workflow/badge)](https://verified-skill.com/skills/busirocket/agents-skills/busirocket-refactor-workflow)

Something wrong with this skill or its page? Tell us.