Orchestrates multi-target code and documentation refactoring with verification gates and review loops.
npx skills add https://github.com/sd0xdev/sd0x-harness --skill refactor-sd0xdev
Please help me install this Agent Skill. Skill: refactor Source: https://github.com/sd0xdev/sd0x-harness/tree/main/skills/refactor Command: npx skills add https://github.com/sd0xdev/sd0x-harness --skill refactor-sd0xdev
--target, or auto-detect up to 10 high-priority targets with --auto using a complexity/change-frequency/isolation scoring formula. - Behavioral Safety Gates: Code targets run /verify fast before and after refactoring to detect behavioral regressions; failing baselines or regressions are skipped with structured [REFACTOR_SKIPPED] logs. - Typed Dispatch: Routes code files to /simplify, AI-artifact docs to /de-ai-flavor, and structural docs to /doc-refactor, each followed by Codex review loops (max 3 rounds). - Reference-Stability Mode: A narrow --mode reference-stability pass converts bare path:line pointers into durable semantic anchors across at most 5 explicitly enumerated files. - Use Case: Run /refactor --auto --max-targets 5 before a release to clean up the five most complex, frequently changed files, then review the per-target result table and commit with /smart-commit --execute. ## Quick Start Ask the assistant to refactor a specific file or directory, for example by requesting to clean up and simplify src/utils.ts with verification and review gates applied.High-intent search queries and answers about installing and using this skill.
Use the refactor skill with --target for specific files or directories, or --auto to auto-detect up to 10 targets scored by complexity, change frequency, and isolation. Each target is refactored, verified, and reviewed independently with a per-target result table.
It runs /verify fast before and after each code refactor and compares exit codes. A 0-to-nonzero transition marks BEHAVIOR_CHANGED and the target is skipped; a failing baseline also skips the target since preservation cannot be verified.
Refactor is the orchestrator for multi-target cleanup across a repo. Use /simplify directly for a single known code file, /de-ai-flavor for a known document with AI artifacts, and /bug-fix or /feature-dev for fixes and new features instead.
Not in v1. Test files (*.test.*, *.spec.*), shell scripts, and config files (JSON/YAML/TOML) are classified as v2 types and skipped with a [REFACTOR_SKIPPED] log. Only code and Markdown documentation targets are dispatched.
Targets are skipped when the baseline verification fails, a behavioral regression is detected, or the file type is v2-only. Targets are blocked when the Codex review loop fails after 3 rounds or the precommit lint/test gate fails.
No. Git add, commit, and push are prohibited. After all gates pass, it lists committable files and suggests running /smart-commit --execute, which remains a user-initiated action.
BerryKuipersRecord code quality metrics before refactoring into a timestamped JSON baseline.
invowkAutomate GitHub pull request workflows with tests, lint, and license checks.
gqf2008Automate pre-commit verification with static security scans and quality gates.
GongYuanCaiJiExecutes small ad-hoc code changes with atomic commits and summary tracking.