skill-writer

To write a SKILL.md file with valid YAML frontmatter, enforce specific naming rules, required description fields, and structured guidance sections to ensure consistent Skill discovery and deployment without friction.

Structuring an Agent Skill for progressive disclosure involves creating a main SKILL.md file alongside optional reference, examples, scripts, and assets folders to keep complex instructions organized and maintainable.

Skill activation or discovery failures usually occur due to invalid YAML frontmatter, incorrect folder structure, or missing description fields, which can be diagnosed and fixed using targeted troubleshooting guidance.

Yes, you can use optional scripts and references when creating a Claude Skill by placing them in dedicated supporting folders, enabling progressive disclosure to keep the main SKILL.md file concise while providing deeper context.

Claude Skill frontmatter requires a valid name and description field to ensure proper discovery, while optional metadata fields can be added to provide additional context without violating strict structural conventions.

No external dependencies are required to build and validate Claude Code Skills, as the validation process relies entirely on standard markdown and YAML frontmatter conventions enforced directly within the SKILL.md file.