skill-creator

To create a custom AI agent skill for OpenCode, structure your project with a SKILL.md file and bundle necessary scripts, references, and assets. Following a step-by-step creation process ensures your skill is properly structured and effective.

Best practices for writing SKILL.md documentation include maintaining conciseness, using progressive disclosure to manage information, and setting clear degrees of freedom for the AI agent. This structure ensures efficient and effective skill execution.

Progressive disclosure in AI skill design is a structural principle that organizes documentation and bundled resources to reveal information progressively. This approach prevents overwhelming the AI agent and maintains skill efficiency.

When building developer guides, you bundle scripts and references by organizing them alongside the main SKILL.md file within the skill directory. This structure provides the AI agent with necessary execution scripts and contextual documentation.

Building custom AI agent capabilities requires a foundational understanding of skill anatomy and design principles. Developers use this guide to structure capabilities, integrate custom APIs, and iterate on skill performance effectively.

You should update an existing AI skill when modifying its structure or adding bundled resources like scripts and references. This guide provides best practices for refining SKILL.md documentation and improving overall skill efficiency.