---
name: troubleshoot
description: Troubleshooting guide for common issues in SnapLogic Robot Framework testing. Use when the user encounters errors, Docker/container issues, environment configuration problems, network connectivity issues, or SnapLogic API errors.
user-invocable: true
---

# Troubleshoot Skill

## Agentic Workflow (Claude: Follow these steps in order)

### Step 1: Load the Complete Guide
```
ACTION: Use the Read tool to load:
{{cookiecutter.primary_pipeline_name}}/.claude/skills/troubleshoot/SKILL.md
```
**Do not proceed until you have read the complete guide.**

### Step 2: Understand the User's Request
Parse what the user wants:
- Specific error message?
- Docker/container issues?
- Environment configuration problems?
- Network connectivity issues?
- SnapLogic API errors?

### Step 3: Follow the Guide
Use the detailed instructions from the file you loaded in Step 1 to:
- Identify the issue category
- Provide diagnostic commands
- Suggest solutions based on error patterns

### Step 4: Respond to User
Provide troubleshooting guidance and solutions based on the complete guide.

---

## Quick Reference

This guide covers:
- Quick diagnostic commands
- Common error messages and solutions
- Docker and container issues
- Environment configuration problems
- Network connectivity troubleshooting
- SnapLogic API errors