atomic-agents

Files (31)

• SKILL.md
• package-summary.md · references/
• repo-provenance.md · references/
• repo-routing-metadata.json · references/
• troubleshooting.md · references/
• check_atomic_agents_env.py · scripts/
• SKILL.md · sub-skills/agent-core/
• api-reference.md · sub-skills/agent-core/references/
• troubleshooting.md · sub-skills/agent-core/references/
• workflows.md · sub-skills/agent-core/references/
• agent_core_smoke.py · sub-skills/agent-core/scripts/
• SKILL.md · sub-skills/example-workflows/
• dependency-matrix.md · sub-skills/example-workflows/references/
• example-index.md · sub-skills/example-workflows/references/
• troubleshooting.md · sub-skills/example-workflows/references/
• workflows.md · sub-skills/example-workflows/references/
• SKILL.md · sub-skills/mcp-integrations/
• api-reference.md · sub-skills/mcp-integrations/references/
• troubleshooting.md · sub-skills/mcp-integrations/references/
• workflows.md · sub-skills/mcp-integrations/references/
• check_mcp_imports.py · sub-skills/mcp-integrations/scripts/
• SKILL.md · sub-skills/repo-development/
• development.md · sub-skills/repo-development/references/
• docs-generation.md · sub-skills/repo-development/references/
• troubleshooting.md · sub-skills/repo-development/references/
• check_repo_layout.py · sub-skills/repo-development/scripts/
• SKILL.md · sub-skills/tooling-and-forge/
• api-reference.md · sub-skills/tooling-and-forge/references/
• cli-reference.md · sub-skills/tooling-and-forge/references/
• forge-catalog.md · sub-skills/tooling-and-forge/references/
• troubleshooting.md · sub-skills/tooling-and-forge/references/

SKILL.md (first lines)

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

From VectorSpaceLab/AREX-Skill, MIT.

More from VectorSpaceLab/AREX-Skill