SKILL

large-file-refactor

Discover large source-file refactor candidates and propose split plans based on cohesion and risk, using available semantic tooling.

Target: Target not categorized. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • Large File Refactor
  • Arguments
  • Workflow
  • Refactor Plan Format
  • Guard Rails
  • Completion

This skill is coordination-exempt: skip the ai-coord gate for its declared work. If a slash or dollar invocation already added these instructions to the conversation, follow them directly. In that case, do not invoke this skill again through a skill tool. Use LOC thresholds to discover candidates, then decide whether a split is justified by cohesion, coupling, ownership, and change risk. Source files match above 1000 LOC. Test files use a relaxed 2000 LOC discovery threshold. path: Optional file or directory to scan. Default: current working directory. --include-generated: Include generated, vendored, dependency, and build-output paths that are skipped by default. 1. Resolve the skill directory, then run the helper from the target repository: 2. Preserve the helper's Markdown table as the exhaustive report. Do not omit matching rows, even when the refactor plan only covers a subset. 3. If the helper reports no threshold matches, stop after the report. A match is a candidate, not proof that the file should be split. 4. Draft a refactor plan for the 3 largest files only, unless the user explicitly requested another count. 5. For each candidate, rank split value by mixed responsibilit

This is an excerpt. Refer to the complete source and its current requirements.

Source repository
PaulRBerg/agent-skills
Source file
skills/large-file-refactor/SKILL.md
Fixed revision
3fc64886b46c95238cdad340a8a04e3aaac96665
Read the complete original documentation ↗

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: PaulRBerg/agent-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-10T00:00:29.945Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.