create-skill

Use router patterns to split knowledge, workflows, references, and scripts into modular components for scalable HX skill authoring. This approach keeps SKILL.md concise while loading detailed content from references as needed.

Choose router-based structures when your HX skill requires progressive disclosure, reference organization, and multiple complex workflows. Use simple structures for straightforward skills without extensive scripts or template reuse requirements.

Validate metadata and ensure XML-only body structure by auditing HX skills against framework requirements. This process checks metadata validity, confirms XML-only body formatting, and verifies coherent workflow integration during skill creation and upgrades.

Progressive disclosure is an authoring technique that keeps SKILL.md concise while loading detailed content from reference files as needed. It manages content by separating core guidance from expanded workflows, templates, and scripts in modular reference files.

Yes, you can reuse templates, references, and scripts to standardize outputs and operations across multiple HX skills. The framework encourages template and reference reuse to maintain consistent metadata and maintainable organization throughout the skill lifecycle.

Simple skill structures lack the modular splitting of knowledge, workflows, and scripts found in router patterns, making them inadequate for expanding workflows. Without progressive disclosure and reference organization, scaling complex skills becomes difficult to maintain.