Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

refactoring-skills

verified

Use when analyzing and refactoring skills in a project. Use when user says "refactor skills", "cleanup skills", "consolidate skills", "skill review". Use when skills are messy or overlapping.

View on GitHub

Marketplace

rcc

wayne930242/Reflexive-Claude-Code

Plugin

rcc

Repository

wayne930242/Reflexive-Claude-Code
7stars

plugins/rcc/skills/refactoring-skills/SKILL.md

Last Verified

February 5, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/wayne930242/Reflexive-Claude-Code/blob/main/plugins/rcc/skills/refactoring-skills/SKILL.md -a claude-code --skill refactoring-skills

Installation paths:

Claude
.claude/skills/refactoring-skills/
Powered by add-skill CLI

Instructions

# Refactoring Skills

## Overview

**Refactoring skills IS applying clean code principles to documentation.**

Consolidate, simplify, extract shared conventions, remove redundancy.

**Core principle:** Fewer focused skills > many overlapping skills.

**Violating the letter of the rules is violating the spirit of the rules.**

## Task Initialization (MANDATORY)

Before ANY action, create task list using TaskCreate:

```
TaskCreate for EACH task below:
- Subject: "[refactoring-skills] Task N: <action>"
- ActiveForm: "<doing action>"
```

**Tasks:**
1. Discover all skills
2. Analyze and classify
3. Execute refactoring plan
4. Extract shared conventions
5. Validate results
6. Generate report

Announce: "Created 6 tasks. Starting execution..."

**Execution rules:**
1. `TaskUpdate status="in_progress"` BEFORE starting each task
2. `TaskUpdate status="completed"` ONLY after verification passes
3. If task fails → stay in_progress, diagnose, retry
4. NEVER skip to next task until current is completed
5. At end, `TaskList` to confirm all completed

## Task 1: Discover All Skills

**Goal:** Find all skills in the project.

**Search locations:**
```bash
find . -name "SKILL.md" -type f 2>/dev/null
ls -la .claude/skills/ 2>/dev/null
```

**Also check:**
- Plugin directories
- User-level skills (`~/.claude/skills/`)

**Document:**
- Skill name
- Location
- Brief description

**Verification:** Complete list of all skills with locations.

## Task 2: Analyze and Classify

**Goal:** Classify each skill for action.

### Classification Matrix

| Status | Criteria | Action |
|--------|----------|--------|
| **Keep** | Well-structured, unique purpose, follows standards | None |
| **Refactor** | Has issues but valuable | Use writing-skills to improve |
| **Merge** | Overlaps with another skill | Consolidate into primary |
| **Extract** | Has conventions shared by others | Move to rule file |
| **Delete** | Redundant, unused, or superseded | Remove entirely |

### Analysis Questions

For ea

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
6094 chars