orchestrate

The 'orchestrate' skill is designed to streamline and prioritize the process of writing and managing documentation chapters within a repository. It addresses the challenge of determining which chapters should be written first and ensures that effort is focused efficiently, avoiding duplication or unnecessary work. By following a structured approach, this skill helps users maintain a clear overview of the documentation project, ensuring that all topics are addressed systematically from specific subtopics to broader chapters.

Key features of 'orchestrate' include the ability to consult a 'priorities.md' file to identify high-priority chapters, guidance on working through chapters alphabetically when no priorities are defined, and rules for skipping directories marked as 'skip'. It also provides a methodology for identifying chapters that require work by checking the root ReadMe.md outline and verifying the existence and content of corresponding ReadMe.md files. Additionally, it enforces a publishing step where completed chapters are linked in the main outline, ensuring that the documentation structure remains up to date.

This skill is particularly useful for technical writers, developers, and project managers involved in large documentation projects or knowledge bases with multiple interrelated topics. Use cases include managing documentation for software projects, educational content, or any structured repository where maintaining completeness and order is critical. By leveraging 'orchestrate', users can prioritize work effectively, reduce redundancy, and maintain a coherent documentation workflow.