tool-failure-diagnostic
CommunityTransform tool failures into diagnostic events for autonomous recovery.
Authorcodysumpter-cloud
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill addresses the issue of tool execution failures by converting them into diagnostic events, enabling the agent to enter a specialized recovery mode instead of halting.
Core Features & Use Cases
- Diagnostic Loop: Captures symptoms, audits context, generates hypotheses, and applies corrective actions.
- Symptom Capture: Extracts
stderrandexit_code. - Context Audit: Checks working directory, dependency existence, and filesystem permissions.
- Hypothesis Generation: Determines if the failure is transient, configuration-related, or logical.
- Corrective Action: Retries, updates configurations, or proposes patches.
- Verification: Re-runs the original command to confirm the fix.
- Use Case: When a command like
ghfails, the skill can automatically check if it's installed and attempt to fix the issue.
Quick Start
Trigger the diagnostic loop for a failed command by using the tool-failure-diagnostic skill.
Dependency Matrix
Required Modules
None requiredComponents
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: tool-failure-diagnostic Download link: https://github.com/codysumpter-cloud/buddy-brain/archive/main.zip#tool-failure-diagnostic Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.