writing-skills

To ensure Claude Skills are discoverable, consolidate and validate SKILL.md entries by applying required YAML frontmatter with name and description fields, and checking alignment with token budgets and category guidelines.

Required SKILL.md frontmatter includes name and description fields. Validating additional metadata like category, keywords, dependencies, and components ensures the Skill Unit meets toxicity requirements and reusability standards.

Audit existing Claude Skills before deployment by validating SKILL.md metadata, verifying token budget alignment, and running toxicity checks to prevent unsafe or unclear skill workflows from being deployed.

Yes, writing-skills validates token budgets and performs toxicity checks on Claude Skills to ensure SKILL.md entries remain safe, clear, and appropriately sized for on-demand loading within workflows.

Use progressive disclosure in Claude Skill documentation when structuring content like quick start guides, references, and scripts, which supports on-demand loading and keeps the SKILL.md concise and focused.

The best way to structure optional resources in a Claude Skill is to follow the standard SKILL.md template, adding assets like scripts and references progressively to support on-demand loading without exceeding token budgets.