# Troubleshoot

> 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.

- Skill: `snaplogic/troubleshoot` (Agent Skill)
- Install (CLI): `npx skillmds@latest add snaplogic/troubleshoot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/snaplogic/troubleshoot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: snaplogic (https://skillmd.com/u/snaplogic)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/snaplogic/troubleshoot

---


# 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