← All skills

troubleshoot

100 / 100 · Low risk

Fine to try.

By BrainBlend-AI/atomic-agents (GitHub) · coding · 6,329 stars · scanned at commit 40a8d28

Diagnose and fix a failing or misbehaving Atomic Agents app — import errors, schema validation failures, empty or malformed LLM output, provider role/mode errors, history and context problems, MCP transport errors. Use when the user reports an error, traceback, or wrong behavior in atomic-agents code, asks "why is my agent not working / crashing / returning garbage", or pastes a `ValidationError`, `ImportError`, or provider API error from an atomic-agents project.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'troubleshoot' ] || [ -L ~/.agents/skills/'troubleshoot' ]; then echo 'A skill folder named troubleshoot already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/BrainBlend-AI/atomic-agents' "$d" && git -C "$d" checkout --quiet '40a8d28311b853d39705be3aab9e88e79d0c96ae' -- 'claude-plugin/atomic-agents/skills/troubleshoot' && mkdir -p ~/.agents/skills && cp -R "$d"/'claude-plugin/atomic-agents/skills/troubleshoot' ~/.agents/skills/'troubleshoot' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'troubleshoot' ~/.claude/skills/'troubleshoot' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for BrainBlend-AI/atomic-agents shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/BrainBlend-AI/atomic-agents.svg)](https://zalavijaysinh.github.io/skilltrust/repos/BrainBlend-AI/atomic-agents/)

Score history