creating-agent-skills

Structure your Skill by choosing between simple and router-based patterns based on complexity. Simple patterns suit single-task skills; router patterns handle multiple intents. Follow progressive disclosure to surface only relevant parameters, organize references clearly, and validate against the official specification to ensure consistency and discoverability.

Design by reading the SKILL.md specification first, then audit your skill against validation checklists. Apply progressive disclosure for parameter presentation, choose the router pattern if handling multiple intents, organize references hierarchically, and use provided templates. Iterate using validation patterns to catch structural issues early.

Use a simple structure for single-task skills with one primary intent. Use a router pattern when your Skill handles multiple distinct intents or workflows that need different processing logic. Router patterns scale better for complex skills but add overhead; choose based on your use case scope.

Organize references hierarchically by topic or function, keeping related content grouped. Scripts should be modular and reusable. The creating-agent-skills guidance explains progressive disclosure—surface only what's needed at each step. This prevents cognitive overload and improves usability.

Audit your Skill using the provided checklists against the official specification. Validate structure consistency, verify progressive disclosure is applied correctly, check reference organization, and test both simple and complex use cases. Iterative improvement patterns catch durability issues before publication.

Yes. XML is supported in Antigravity Skills. Refer to the specification and templates for correct usage patterns, schema validation, and integration with the router pattern if needed. Progressive disclosure applies to XML-based parameter presentation as well.