create-agent-skills

Create a SKILL.md file with YAML frontmatter (64-character name and description) followed by pure XML containing required tags: <objective>, <quick_start>, and <success_criteria>. Optional tags like <workflow>, <validation>, <examples>, and <reference_guides> support progressive disclosure and keep documentation modular and scannable.

Progressive disclosure reveals information in layers—essential details first, advanced content on demand. In Skill documentation, this keeps SKILL.md concise and focused while optional tags like <advanced_features> and <security_checklist> provide depth without overwhelming new users.

Include a <validation> section with structured templates covering input constraints, output expectations, and error handling. Validation patterns standardize how Skills enforce requirements, test edge cases, and communicate failures, improving reliability across skill-based workflows.

Yes, slash-command style routing wrappers standardize how users invoke Skills and help organize commands by intent. This pattern enhances discoverability and keeps skill interaction consistent within Claude Code environments.

Add a <reference_guides> tag containing linked documentation, external APIs, or related resources. Reference integration in SKILL.md centralizes knowledge dependencies, making skills self-documenting and easier for users to extend or understand context.

Use exactly 64 characters for both name and description in YAML frontmatter. Clear, concise naming improves searchability and consistency across skill collections, ensuring users find and understand skills quickly.