refactor-skill

To modularize a monolithic SKILL.md file, extract its content into separate files within a `references/` directory and parameterize hardcoded values into a `config.yaml` to improve maintainability and organization.

Parameterize hardcoded values by extracting them into a `config.yaml` file during the refactoring process, allowing for easy customization and reuse across multiple projects without altering the core skill logic.

You need to refactor a monolithic skill file when it exceeds 500 lines, contains hardcoded project-specific values, or would benefit from progressive disclosure patterns to improve content management and readability.

The best way to break down a 1000-line SKILL.md file is to split it into a modular structure by moving content to `references/` and extracting variables to `config.yaml`, then validating the refactored structure for content integrity.

Yes, refactoring validates the refactored structure and content integrity, ensuring that the modularization into `references/` and parameterization into `config.yaml` preserve the original skill's logic and functionality.

Yes, you can apply progressive disclosure patterns for skill management by refactoring monolithic files into a modular structure, moving detailed content to `references/` to optimize performance and maintainability.