update-skill

Update skill documentation by analyzing your conversation history to identify the problem, solution, and missing context, then apply targeted edits to the skill's SKILL.md file. This automates incorporating learnings into prerequisites, instructions, troubleshooting sections, or frontmatter based on what you discovered during debugging.

Document the exact steps and root causes from issues you've resolved—such as enabling developer mode or configuring environment variables. Capturing these learnings in the troubleshooting section ensures future users avoid the same problems and reduces debugging effort across repeated skill executions.

Yes, this skill automates documentation improvements by extracting root causes and fixes from troubleshooting conversation history, then applying targeted edits to prerequisites, instructions, troubleshooting, and frontmatter. This makes skills more robust and prevents repeated issues over time.

Update SKILL.md when troubleshooting reveals missing prerequisites, incomplete instructions, or undocumented edge cases—not just code bugs. Documentation updates ensure the next user with the same problem finds the answer immediately without repeating your debugging work.

Skill documentation must maintain valid YAML frontmatter, proper Markdown formatting, and categorized sections for prerequisites, instructions, and troubleshooting. This skill validates your edits to ensure documentation remains parseable and consistent across all skills.