What problem does it solve? Writing a valid SKILL.md for VoiceOS requires knowing the exact YAML frontmatter schema, size limits, naming rules, and directory placement conventions, and mistakes cause validation failures or undiscoverable skills. ## Core Features & Use Cases - Frontmatter Specification: Defines the required YAML fields (name, description, version, author, license, metadata.voiceos tags) and their constraints, such as the 1024-character description limit. - Structure and Size Guidance: Prescribes the recommended section layout (Overview, When to Use, Pitfalls, Verification Checklist) and the 100,000-character file limit with progressive disclosure advice. - Placement and Workflow Rules: Distinguishes user skills under workspace/skills/ from bundled skills under skills/bundled/, with a step-by-step authoring and validation workflow. - Use Case: When asked to add a new skill to the VoiceOS repository, follow this guide to draft the SKILL.md, validate the name and description lengths, and commit it to the correct bundled category directory. ## Quick Start Ask the assistant to create a new VoiceOS skill named my-skill with proper frontmatter and commit it under skills/bundled/community.
