skill-creator

To create spec-compliant AgentSkill frontmatter, you must define the name and description fields in the SKILL.md YAML block. This ensures correct metadata validation and allows constrained naming conventions for token-efficient context loading.

Progressive disclosure in skill authoring structures SKILL.md content to avoid context bloat. By organizing operational instructions and separating bundled files into scripts, references, and assets, it minimizes token consumption during context loading.

To audit and tidy an existing AgentSkill directory, validate its SKILL.md frontmatter against spec conventions and review its resource organization. This process cleans up structural inconsistencies and ensures efficient operational instruction formatting.

You should use scripts, references, and assets folders to organize bundled files separately from SKILL.md operational instructions. This directory structuring approach keeps the main skill file lightweight while supporting progressive disclosure for token efficiency.

AgentSkill spec validation requires correct YAML frontmatter containing name and description fields. It enforces constrained naming and structure conventions to maintain directory organization and ensure the skill remains easy for agents to use.

Yes, you can edit existing skills by validating the YAML frontmatter and reviewing directory organization against spec conventions. This audit process ensures your edits maintain compliance without breaking the progressive disclosure rules.