bd-skill-creating

To create an AI agent skill, follow a structured workflow: define the skill's purpose, establish clear naming conventions, organize content in SKILL.md, and place detailed instructions in the references directory.

To structure an AI agent skill for discoverability, keep the SKILL.md file concise and move detailed instructions into the references directory, following the open agent-skills standard for clear naming conventions and content organization.

The best way to organize content in an agent's SKILL.md file is to keep it concise and focused on core instructions, while placing detailed documentation in the references directory to maintain progressive disclosure.

Following the open agent-skills standard is necessary to build effective agent capabilities, as it enforces progressive disclosure, clear naming conventions, and structured content organization to ensure skills are discoverable and efficient.