Agent skill · writing content · jeremylongshore
clade-advanced-troubleshooting
Debug complex Claude issues \u2014 inconsistent outputs, tool use failures,\n\
Why this skill is useful
Provides specific debugging patterns and code snippets for handling advanced issues with Claude integration that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Anthropic Advanced Troubleshooting Overview Debug complex Claude integration issues that go beyond basic error handling — inconsistent outputs, tool use failures where Claude calls nonexistent tools, streaming connection drops, maxtokens truncation, and image/vision format problems. Inconsistent Outputs Symptom: Same prompt gives different answers each time. Cause: temperature defaults to 1.0 (maximum randomness). Tool Use Failures Symptom: Claude calls a tool that doesn't exist or sends wrong parameters. Streaming Connection Drops Symptom: Stream stops mid-response without messagestop event. maxtokens Truncation Symptom: Response cuts off mid-sentence. Image/Vision Issues Symptom: Claude says it can't see the image. Max image size: 5MB Supported: PNG, JPEG, GIF, WebP Max 20 images per request Base64 encoding must be correct (no data URI prefix in the data field) Output Inconsistent outputs fixed via temperature control Tool use validated against defined tool names before execution Streaming connection drops detected and retried Truncated responses identified via stopreason check Image format issues resolved (correct mediatype, raw base64, size limits) Error Handling Error Cause Solution ------- ------- ---------- API Error Check error type and status code See clade-common-errors Examples See Inconsistent Outputs (temperature fix), Tool Use Failures (validation), Streaming Connection Drops (detection), maxtokens Truncation (stopreason check), and Image/Vision Issues (correct format) above. Resources Error Types Tool Use Guide Vision Docs Next Steps See clade-debug-bundle for collecting support evidence. Prerequisites Completed clade-common-errors for basic error handling Familiarity with Claude API response structure Access to application logs with full request/response data Instructions Step 1: Review the patterns below Each section contains production-ready code examples. Copy and adapt them to your use case. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clade-advanced-troubleshooting