refactor

Refactor Ruby files to detected conventions with audits and changelogs.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/b08x/syncopated-context --skill refactor-b08x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/b08x/syncopated-context/tree/main/plugins/rubysmithing/skills/refactor
Command: npx skills add https://github.com/b08x/syncopated-context --skill refactor-b08x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps Ruby teams ensure code quality by auditing and applying convention-driven refactors, surfacing a pre-refactor audit, the fully rewritten file, and a change log.

Core Features & Use Cases

  • Audits code against detected project conventions (RuboCop, StandardRB, Rubysmith) and recommends targeted refactors.
  • Performs mode selection (Lite vs Standard) based on file size and complexity, processing multiple files in dependency order.
  • Verifies Zeitwerk compliance after refactoring and generates a changelog with rationale for each change.
  • Provides an auditable workflow that makes refactoring transparent and reversible.

Quick Start

Use this skill by providing the target Ruby file path; the skill will audit, refactor toward project conventions, and output a change log.

Frequently Asked Questions about refactor

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

FAQPage Schema
How do I refactor Ruby code to match project conventions?

Ruby refactoring is driven by detecting conventions like RuboCop, StandardRB, or Rubysmith, producing a pre-refactor audit, a rewritten compliant file, and a changelog.

How do I ensure refactored Ruby files are Zeitwerk compliant?

Zeitwerk compliance is verified by checking module and class names match file paths, avoiding unsafe requires, and returning a rewritten file with a behavioral note.

Can I refactor multiple Ruby files in dependency order?

Multiple Ruby files are processed in dependency order, with Lite or Standard mode selected based on input size and complexity for each refactoring task.

Does this refactoring workflow generate a changelog with rationale?

A changelog is generated providing rationale for each change, making the convention-driven refactoring workflow transparent, auditable, and reversible.

What is the difference between Lite and Standard refactoring modes?

Lite and Standard refactoring modes are selected based on input size and complexity, ensuring the appropriate depth of convention-driven code transformations.

What do I need to provide to start a Ruby code audit?

To start a Ruby code audit, provide the target Ruby file path; the skill audits, refactors toward detected project conventions, and outputs a change log.