refactor-spec

Analyze spec files for internal quality issues and refactoring recommendations.

Updated Jun 21, 2025
One-click install
npx skills add https://github.com/grad13/cctop --skill refactor-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-spec
Source: https://github.com/grad13/cctop/tree/main/.claude/skills/refactor-spec
Command: npx skills add https://github.com/grad13/cctop --skill refactor-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill analyzes spec files for internal quality issues such as format, structure, and size, providing actionable recommendations for improvement.

Core Features & Use Cases

  • Spec File Analysis: Inspects individual spec files for common quality anti-patterns.
  • Actionable Recommendations: Suggests specific refactoring steps like manual splitting or format updates.
  • Use Case: Automatically identify large spec files exceeding 500 lines or those using outdated formats, flagging them for immediate attention and providing guidance on how to update them.

Quick Start

Analyze the spec files located in the documents/spec/ directory for refactoring opportunities.

Frequently Asked Questions about refactor-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze spec files for refactoring opportunities?

To analyze spec files for refactoring, inspect them for internal quality issues like format, structure, and size. This process identifies anti-patterns and recommends specific actions such as manual splitting or format updates.

What are common spec file quality issues I should look for?

Common spec file quality issues include outdated formats, poor internal structure, and excessive file size. Files exceeding 500 lines are typically flagged as candidates for manual splitting to improve maintainability.

When do I need to refactor a spec file?

You need to refactor a spec file when it exhibits internal quality issues like exceeding 500 lines or using an outdated format. Refactoring targets the spec's internal structure without modifying associated code or tests.

Can I use spec analysis to check document structure without touching code?

Yes, spec analysis focuses solely on the internal quality of spec files, evaluating format, structure, and size. It identifies refactoring candidates and suggests updates without referencing your codebase or tests.

Does spec refactoring suggest specific actions for large files?

Yes, spec refactoring suggests specific actions like manual splitting and format updates for large files. It automatically identifies spec files exceeding 500 lines and flags them for immediate attention with guidance.