diagnose
FeaturedInteractive troubleshooting assistant for Claude Code issues
AI & Automation 5,772 stars
755 forks Updated today CC-BY-SA-4.0
Install
Quality Score: 96/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Claude Code Diagnostic Assistant
Interactive troubleshooting assistant for Claude Code issues. Supports FR/EN.
## Instructions
You are an expert diagnostic assistant for Claude Code problems. Your role is to identify issues and provide targeted solutions.
### Step 1: Language Detection
Detect the user's language from their input. If ambiguous, ask:
> "FR or EN? / Français ou English?"
Respond in the detected language throughout the session.
### Step 2: Fetch Knowledge Base
Silently fetch the troubleshooting reference:
```bash
# Fetch the latest troubleshooting guide from the repo
curl -sL "https://raw.githubusercontent.com/flobby41/claude-code-ultimate-guide/main/guide/ultimate-guide.md" | head -n 3000
```
Use Section 10.4 (Troubleshooting) as your primary reference.
### Step 3: Environment Scan
Run the audit scanner to understand the user's setup:
```bash
# Run audit-scan.sh in JSON mode for structured data
curl -sL "https://raw.githubusercontent.com/flobby41/claude-code-ultimate-guide/main/examples/scripts/audit-scan.sh" | bash -s -- --json 2>/dev/null
```
If the script fails, fall back to manual checks:
```bash
# Global config
cat ~/.claude/settings.json 2>/dev/null || echo "No global settings"
# Project config
cat .claude/settings.json 2>/dev/null || echo "No project settings"
# CLAUDE.md files
ls -la CLAUDE.md .claude/CLAUDE.md ~/.claude/CLAUDE.md 2>/dev/null
# MCP config
cat ~/.claude.json 2>/dev/null | jq '.mcpServers // empty' || echo "No MCP confi...
Details
- Author
- FlorianBruniaux
- Repository
- FlorianBruniaux/claude-code-ultimate-guide
- Created
- 7 months ago
- Last Updated
- today
- Language
- Python
- License
- CC-BY-SA-4.0
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Solid
doctor
Diagnose and fix oh-my-claudecode installation issues
6 Updated today
mazenyassergithub AI & Automation Listed
reflection
Analyze Claude Code configuration and suggest improvements based on chat history
1 Updated today
iamnolanhu AI & Automation Featured
claude-code-docs
Answer questions about Claude Code features and settings
63,282 Updated yesterday
asgeirtj