Refactor Skills Command

Systematically analyze all skills and apply refactoring for quality and consistency.

Process

1. Invoke Architecture Advisor

Use the agent-architect skill to get a holistic view of the current skill landscape.

2. Discover All Skills

find . -name "SKILL.md" -type f

3. Analyze Each Skill

For each skill, classify:

Status	Action
Keep	Well-structured, unique purpose
Refactor	Has issues but valuable
Merge	Overlaps with another skill
Extract	Has conventions shared by other skills → move to Rules
Delete	Redundant or unused

Use the write-skill skill to understand quality standards.

Key insight: Rules = conventions/guidelines shared across skills. If multiple skills repeat the same convention, extract it to .claude/rules/.

4. Apply Refactoring

For skills to refactor: Use the write-skill skill to guide improvements.

For skills to merge:

• Identify the primary skill
• Consolidate unique content
• Delete the redundant skill

For shared conventions to extract:

• Use write-rules skill to create rule in .claude/rules/
• Remove duplicated convention from each skill
• Skills now reference the shared rule

For skills to delete:

• Confirm no dependencies
• Remove entire skill directory

5. Validate Results

python3 skills/write-skill/scripts/validate_skill.py <skill-path>

6. Generate Report

## Refactoring Summary

### Skills Analyzed: N

### Actions Taken:
- Kept: X skills
- Refactored: Y skills
- Merged: Z skills
- Extracted to Rules: A conventions
- Deleted: W skills

### Changes Made:
- [skill-name]: [action taken]

### Rules Created:
- [rule-file]: [convention extracted from skills]

Example Usage

/rcc:refactor-skills