edit-skill

To create a Claude Code skill, use structured templates to scaffold frontmatter with name and description fields, then apply validation checks to ensure formatting consistency and reduce authoring errors.

The best way to modify existing Claude Code skills is applying surgical edits using validation guidance and modification patterns to safely update triggers, extend structure, or adjust guidance without breaking existing functionality.

Progressive disclosure keeps SKILL.md concise by embedding context-aware templates that surface minimal guidance initially, offering deep references and optional scripts only when needed to maintain token-efficiency.

Yes, you can add optional scripts, references, and assets when editing Claude Code skills, using modification patterns that enforce frontmatter requirements and safety checks while extending the skill's capabilities.

Frontmatter validation fails when required name and description fields are missing or incorrectly formatted; the skill enforces strict frontmatter requirements during creation and modification to prevent structural errors.

Safety checks enforced during skill updates include frontmatter validation, token-efficiency verification, and delegation of uncertain tooling decisions to the edit-tool orchestrator to prevent unsafe modifications.