// 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.
| name | release |
| description | 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. |
| allowed-tools | Read, Bash, Grep, Glob |
This skill guides the release process for atomic-agents, including version bumping, PyPI publishing, and GitHub release creation.
main branch with clean working directory.env file must contain PYPI_TOKEN environment variable| Type | When to Use | Example |
|---|---|---|
major | Breaking changes | 2.5.0 → 3.0.0 |
minor | New features (backwards compatible) | 2.5.0 → 2.6.0 |
patch | Bug fixes only | 2.5.0 → 2.5.1 |
git checkout main
git pull
git status # Ensure clean working directory
Important: The script bumps versions, so if it fails partway through, reset to main before retrying.
powershell -ExecutionPolicy Bypass -File build_and_deploy.ps1 <major|minor|patch>
This script will:
pyproject.tomlpyproject.toml with new versionuv sync to update dependenciesuv build to create distribution packagesuv publish to upload to PyPIgit checkout main
git reset --hard origin/main
# Fix the issue, then run script again
git add pyproject.toml uv.lock
git commit -m "Release vX.Y.Z"
git push
gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES_HERE"
## What's New
### Feature Name
Brief description of the feature.
#### Features
- Feature 1
- Feature 2
#### Improvements
- Improvement 1
#### Bug Fixes
- Fix 1
### Full Changelog
https://github.com/BrainBlend-AI/atomic-agents/compare/vOLD...vNEW
.env file has PYPI_TOKENGuide for the Atomic Agents Python framework — schemas, agents, tools, context providers, prompts, orchestration, and provider configuration. Use when code imports from `atomic_agents`, defines an `AtomicAgent`, `BaseTool`, or `BaseIOSchema`, or the user asks about multi-agent orchestration or LLM-provider wiring in an atomic-agents project.
Build and wire an `AtomicAgent[InSchema, OutSchema]` — schemas, `AgentConfig`, `SystemPromptGenerator`, provider client, history, hooks, optional context providers. Use when the user asks to "create an agent", "add another agent", "build an `AtomicAgent`", "wire up an agent", "make a planner/router/extractor agent", or runs `/atomic-agents:create-atomic-agent`.
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. Use when the user asks to "add a context provider", "inject X into the prompt", "give the agent dynamic context", "wire up RAG", "make a `BaseDynamicContextProvider`", or runs `/atomic-agents:create-atomic-context-provider`.
Design and write a `BaseIOSchema` input/output pair for an Atomic Agents agent or tool — docstrings, field descriptions, validators, error variants. Use when the user asks to "create a schema", "design the input/output schema", "define an `IOSchema`", "write a `BaseIOSchema`", "model the agent's output", or runs `/atomic-agents:create-atomic-schema`.
Build a `BaseTool[InSchema, OutSchema]` subclass — input/output schemas, `BaseToolConfig`, `run()` (and optional `run_async()`), env-driven secrets, typed failure outputs. Use when the user asks to "add a tool", "create a tool", "wrap an API as a tool", "build a `BaseTool`", "make a calculator/search/weather tool", or runs `/atomic-agents:create-atomic-tool`.
Scaffold a new Atomic Agents project from scratch — create the directory, `pyproject.toml`, env file, first agent, and a runnable entry point. Use when the user asks to start a new atomic-agents project from scratch, says "scaffold" / "new project" / "start from zero", or runs `/atomic-agents:new-app`.