# Directory Structure

> This skill provides advanced troubleshooting techniques for difficult Retell AI issues.

- Skill: `tools-only/directory-structure-11` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/directory-structure-11`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/directory-structure-11/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/directory-structure-11

---

# retellai-advanced-troubleshooting

> Apply advanced debugging for hard-to-diagnose issues including audio quality, latency, and transcription accuracy

## Directory Structure

```
retellai-advanced-troubleshooting/
├── SKILL.md
└── examples/
    └── example.py
```

## File Descriptions

| File | Type | Purpose |
|------|------|---------|
| SKILL.md | Markdown | Core skill instructions for advanced troubleshooting techniques |
| examples/example.py | Python | Example diagnostic scripts for deep investigation |

## Summary

**Category:** advanced
**Target Audience:** Senior SREs, Staff engineers, Support escalation engineers
**Trigger Phrases:** `retell hard bug`, `retell mystery error`, `retell audio issues`, `difficult retell issue`

### What This Skill Does

This skill provides advanced troubleshooting techniques for difficult Retell AI issues. It covers audio quality analysis using FFprobe and spectrum analysis, latency profiling across the voice pipeline, transcription accuracy investigation, WebSocket connection debugging, and creating minimal reproductions for support escalation.

### Technical Success Criteria

- Comprehensive debug bundle created
- Failure layer identified (audio, STT, LLM, TTS, network)
- Minimal reproduction created
- Support escalation submitted with full context
- Resolution path identified

### Business Success Criteria

- Resolved edge-case issues that block production
- Improved system understanding
- Successfully diagnose 95% of escalated issues

## Related Skills

- retellai-debug-bundle - Initial diagnostic collection
- retellai-incident-runbook - Incident response procedures
- retellai-realtime-streaming - WebSocket debugging