Atomic Agents

Use this skill when a task mentions Atomic Agents, atomic-agents, atomic-assembler, Atomic Forge, MCP connectors, the example projects, or editing this repository.

Start here

1. Read references/package-summary.md for the monorepo map, package names, and core terminology.
2. Read references/repo-provenance.md before deciding whether this skill matches the current checkout or needs refresh.
3. Read references/troubleshooting.md for cross-cutting install, import, CLI, and version-mismatch issues.
4. Use the route map below. Each subskill owns deeper references and any helper scripts.

Install and smoke check

• Public use: pip install atomic-agents
• Checkout work: uv sync or pip install -e .
• Smoke check: python -c "import atomic_agents, atomic_assembler; print(atomic_agents.__version__)"
• CLI check: atomic --help

Route map

User task	Use subskill	Why
Build, run, stream, or debug a typed AtomicAgent with schemas, history, prompts, hooks, token counting, or multimodal content	sub-skills/agent-core/SKILL.md	Owns the core agent API, memory, context providers, hooks, and the fundamental schema contract.
Define tools/resources/prompts, reason about Atomic Forge tool families, use the atomic CLI, or adapt tool-selection patterns	sub-skills/tooling-and-forge/SKILL.md	Owns BaseTool, BaseResource, BasePrompt, Atomic Forge, Atomic Assembler, and tool orchestration surfaces.
Connect to MCP servers or troubleshoot dynamic MCP-generated tools, resources, and prompts	sub-skills/mcp-integrations/SKILL.md	Owns the MCP transport, schema transformation, and generated tool/resource/prompt factory surface.
Adapt a concrete example project such as quickstart, multimodal, RAG, orchestration, memory, hooks, YouTube, DSPy, FastAPI, progressive disclosure, or mcp-agent	sub-skills/example-workflows/SKILL.md	Owns the example catalog, dependencies, and recipe-level guidance.
Modify this checkout, run focused tests, update docs, or reason about release/CI behavior	sub-skills/repo-development/SKILL.md	Owns monorepo development commands, packaging conventions, docs checks, and maintainer workflow guidance.

Shared references and helpers

• references/repo-routing-metadata.json records the router metadata consumed during import into the repo-skills router.
• scripts/check_atomic_agents_env.py performs a safe import/version/CLI smoke check.
• Read each subskill's references/ and scripts/ for workflow-specific guidance.