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.