Troubleshooting Guide Builder

What this skill does

This skill builds a structured troubleshooting guide that maps symptoms to causes to fixes for any software tool, API, or system. Each entry follows a consistent format: what the user experiences, why it happens, and exactly how to fix it — including specific commands, configuration changes, or code snippets. The result is a guide that developers or support staff can scan quickly to resolve issues without digging through source code or guessing.

Use this when writing documentation for a new tool, after an incident reveals a common failure mode, when your support team keeps answering the same questions, or when preparing runbooks for operational issues.

How to use

Claude Code / Cline

Copy this file to .agents/skills/troubleshooting-guide-builder/SKILL.md in your project root.

Then ask:

• "Use the Troubleshooting Guide Builder skill to write a troubleshooting guide for our CLI tool."
• "Build a troubleshooting guide for the most common deployment errors using the Troubleshooting Guide Builder skill."