skill-creator

Structure an AI agent skill by organizing the SKILL.md file alongside bundled resources like scripts, references, and assets. This architecture applies progressive disclosure patterns to manage context efficiently and prevent token overload.

Best practices for writing SKILL.md documentation include maintaining conciseness, setting clear degrees of freedom for the AI agent, and applying progressive disclosure to reveal information only when needed.

The skill creation process involves understanding the core task, structuring the SKILL.md anatomy, organizing supporting scripts and references, and iterating on the design based on agent performance.

Organize scripts and references by bundling them into dedicated directories within the skill unit, allowing the AI agent to access supporting code and documentation without cluttering the main context window.

Use progressive disclosure patterns in skill creation when the documentation or logic is too complex for a single prompt, ensuring the AI agent loads detailed references or scripts only when the specific task requires them.