skill-creator

To create an AI skill, follow best practices for structuring content in the SKILL.md file and managing bundled resources like scripts and documentation. This ensures skills are efficient, well-structured, and properly augmented for AI agents.

Best practices for writing skill documentation include adhering to conciseness, progressive disclosure, and appropriate degrees of freedom. These core principles ensure the documentation effectively guides AI agents without overwhelming them with unnecessary content.

Manage bundled scripts and references by placing executable logic in the scripts directory and supporting material in references. This separation maintains a clean skill structure and allows AI agents to access documentation only when needed.

When creating a skill to interact with an API, you should package the API documentation within the references directory. This organization maintains skill conciseness while providing agents necessary external context.

AI skills fail to follow instructions when documentation lacks conciseness or appropriate degrees of freedom. Overly detailed skills can overwhelm agents, so applying progressive disclosure principles ensures the agent processes core tasks effectively.