skill-best-practices

You validate agent skill metadata by applying checklist-based validation to your draft directory, verifying YAML frontmatter rules, directory structure, and helper-path conventions for agentskills.io compliance. This process refines SKILL.md files until all checks pass.

The correct directory structure for a compliant agent skill includes dedicated folders for scripts, references, and assets. This layout supports deterministic helper references and progressive disclosure patterns required for agentskills.io validation.

You write procedural instructions for an agent skill by using deterministic authoring patterns that enable progressive disclosure. This approach ensures consistent execution without guessing at metadata or structural requirements during skill activation.

YAML frontmatter requirements for publishing an agent skill mandate compliant metadata fields for name and description rules. The validation checklist verifies these fields to ensure proper discovery and activation on agentskills.io.

Yes, you can use skill-best-practices to review an existing SKILL.md file. It validates metadata, checks helper-path conventions, and refines procedural instructions to ensure your current skills meet agentskills.io compliance standards.