What is the primary purpose of the start-refactor-task skill?

It is designed to automate the process of starting, tracking, and completing specific refactoring tasks based on a structured task file, often used in multi-agent workflows.

How do I mark a task as finished?

You can use the --complete flag followed by the task ID to update the status to COMPLETE in the task file.

Can this skill be used to optimize AI agents?

Yes, it includes a specific AGENT_OPTIMIZE workflow that improves instruction clarity, trigger keywords, and tool restrictions for AI agents.

What happens if a verification step fails?

If verification fails, the skill will attempt up to three fixes; if it still fails, it stops and reports the failure details to the user or orchestrator.

How does it handle dependencies between tasks?

The skill automatically scans the task file for dependencies and will only allow a task to start if all its requirements are marked as complete.

Refactor Task Manager

Name: Refactor Task Manager
Author: Jamie-BitFlight

byJamie-BitFlight

•

Productivity & Workflow

Orchestrates complex codebase refactoring workflows by managing task states, dependencies, and sub-agent execution.

The Refactor Task Manager skill provides a standardized framework for executing sophisticated refactoring missions within Claude Code. It allows for the systematic handling of tasks such as splitting monolithic skills, optimizing agent prompts, and resolving structural issues. By utilizing a task file as a source of truth, it ensures that sub-agents follow specific acceptance criteria, track progress through various states, and perform rigorous verification before marking work as complete, making it ideal for large-scale codebase maintenance and AI-driven architecture improvements.

Key Features

01Automated task state management from 'Not Started' to 'Complete'

02Dependency-aware task selection for sequential refactoring

03Specialized workflows for skill splitting, agent optimization, and documentation

0418 GitHub stars

05Integrated verification steps to ensure cross-reference and link integrity

06Granular progress tracking via the Task API for acceptance criteria

Use Cases

01Breaking down large skill files into modular, domain-specific components

02Orchestrating multiple sub-agents to perform parallel refactoring tasks

03Standardizing AI agent descriptions and instructions across a plugin ecosystem

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills start-refactor-task

For use in Claude.ai and ChatGPT

Download Skill