skill-troubleshooting
Installation
SKILL.md
SKILL: TROUBLESHOOTING & ISSUE RESOLUTION
STEP 1: CHECK KNOWN ISSUES FIRST
Before trying random solutions: search .agents/troubleshooting/known-issues.yaml.
WebView symptom shortcuts:
- Black screen → webview-007 / webview-010
- Messy / unstyled / overlapping HTML → webview-011 (
resolutions/webview-011-unstyled-external-css.md) - Knob dots, no arcs → webview-008
# Search known issues database
$errorPattern = "duplicate target juce"
$knownIssues = Get-Content ..claude\troubleshooting\known-issues.yaml | ConvertFrom-Yaml
$matches = $knownIssues.issues | Where-Object {
$_.error_patterns -match $errorPattern
}