skill-optimization-guide

To optimize lengthy SKILL.md documentation, refactor the structure by minimizing length, eliminating redundancy, and consolidating information to improve usability and clarity. This process involves evaluating the document structure and merging duplicate sections.

The best way to structure complex skill package documentation is to apply navigation hub principles, extract code blocks into separate references, and consolidate redundant sections to create a comprehensive yet concise reference.

You need to refactor your coding standards documentation when the file becomes unwieldy, inefficient, or outgrows its initial structure, particularly if it contains redundancy that impacts overall usability.

Extracting code to references improves document structure by offloading implementation details from the main SKILL.md file. This minimizes the document length and streamlines the primary navigation hub for better readability.

Yes, you can merge duplicate sections in SKILL.md without losing information by consolidating the overlapping content. This refactoring step eliminates redundancy while maintaining a comprehensive reference for developers.