add-skill

To create a valid SKILL.md file, you must include frontmatter with at least the required name and description fields. This ensures proper skill documentation structure and discoverability across platforms like OpenCode or Claude.

The required frontmatter for agent skill creation includes mandatory name and description fields. Proper validation also checks optional metadata like keywords, dependencies, components, and safety attributes to ensure a well-formed skill unit.

When writing a SKILL.md file, you organize optional references and assets by following a consistent template that validates file organization. This structural validation ensures your skill content remains scalable and properly formatted for agent use.

You can update existing skill descriptions safely by enforcing frontmatter requirements and validating metadata like keywords and dependencies. This refinement process ensures your updated markdown maintains a valid skill unit structure.

The best way to validate safety and metadata in skill documentation is by enforcing frontmatter requirements and checking structural organization. This validation process ensures your SKILL.md file meets all necessary safety and component standards.