skill-creator

To structure an AI skill, create a required SKILL.md file alongside optional scripts, references, and assets directories. This organization ensures your AI extensions are modular, discoverable, and maintainable.

Progressive disclosure in AI skill creation is a design principle that structures SKILL.md content and resource organization to provide information incrementally, setting appropriate degrees of freedom for the AI agent.

The best way to package AI skills is to follow a structured development workflow that organizes documentation, scripts, and references into standard directories, ensuring the final extension is efficient and easily discoverable.

Yes, you can use custom scripts and reference documents when building AI extensions by placing them in the optional scripts/ and references/ directories. This allows the AI agent to access specialized logic and contextual documentation during execution.

Yes, a SKILL.md file is required for every AI skill creation to define the core behavior. Additional documentation can be progressively disclosed through the references directory to maintain conciseness and efficiency.

AI agents may fail to discover newly created skills when the SKILL.md lacks conciseness or when resources are poorly organized in the scripts/ and references/ directories. Following proper design principles for modular extensions ensures discoverability.