Skip to content
anyai.fyi

troubleshoot

Skill from BrainBlend-AI/atomic-agents

Agents & Workflows No risky patterns found curated agentscodeapimcpllm

Install

npx skills add BrainBlend-AI/atomic-agents --skill troubleshoot

Runs the open skills CLI and installs the skill for your agent (Claude Code, Codex, Cursor …). Alternatively copy the skill folder into .claude/skills/ or upload it in Claude.ai under Settings → Skills.

As a Claude Code plugin

/plugin marketplace add anthropics/claude-plugins-official /plugin install atomic-agents@eigenwise

This skill is part of the plugin “atomic-agents”. In Claude Code the plugin installs it together with the plugin’s other skills, commands and hooks.

What does the troubleshoot skill do?

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.

Description from the SKILL.md in the source repository.

Questions about troubleshoot

What does the troubleshoot skill do?

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.

How do I install troubleshoot?

In a terminal: npx skills add BrainBlend-AI/atomic-agents --skill troubleshoot. The skills CLI asks which agents to install it for. In Claude.ai you can upload the skill folder as a ZIP under Settings → Skills.

Which agents can use troubleshoot?

Skills use the open SKILL.md format, which Claude Code, Claude.ai, the Claude API, OpenAI Codex, Cursor, Gemini CLI and other agents support.

Is troubleshoot safe to use?

Our automatic check found no risky patterns (piped shell scripts, hidden characters, secret access, prompt overrides). It is not a full audit – read the SKILL.md and any scripts before installing.

More skills from BrainBlend-AI/atomic-agents

release
BrainBlend-AI/atomic-agents

Release a new version of atomic-agents to PyPI and GitHub. Use when the user asks to "release", "publish", "deploy", or "bump version" for atomic-agents.

DevOps & Cloud curated
Worth a look
create-atomic-agent
BrainBlend-AI/atomic-agents

Build and wire an `AtomicAgent[InSchema, OutSchema]` — schemas, `AgentConfig`, `SystemPromptGenerator`, provider client, history, hooks, optional context providers.

Agents & Workflows curated
No risky patterns found
create-atomic-context-provider
BrainBlend-AI/atomic-agents

Build a `BaseDynamicContextProvider` that injects a named, titled block into an agent's system prompt at every `run()` — current time, user identity, retrieved RAG docs, session state, cached DB schema.

Agents & Workflows curated
No risky patterns found
create-atomic-schema
BrainBlend-AI/atomic-agents

Design and write a `BaseIOSchema` input/output pair for an Atomic Agents agent or tool — docstrings, field descriptions, validators, error variants.

Design & Media curated
No risky patterns found
create-atomic-tool
BrainBlend-AI/atomic-agents

Build a `BaseTool[InSchema, OutSchema]` subclass — input/output schemas, `BaseToolConfig`, `run()` (and optional `run_async()`), env-driven secrets, typed failure outputs.

Development curated
No risky patterns found
framework
BrainBlend-AI/atomic-agents

Guide for the Atomic Agents Python framework — schemas, agents, tools, context providers, prompts, orchestration, and provider configuration.

Development curated
No risky patterns found
new-app
BrainBlend-AI/atomic-agents

Scaffold a new Atomic Agents project from scratch — create the directory, `pyproject.toml`, env file, first agent, and a runnable entry point.

Agents & Workflows curated
Worth a look

Related skills in Agents & Workflows