Build with coding agents

The aixplain-builder skill lets a coding agent build, run and deploy anything the SDK supports from a plain-English request.

It covers agents and subagents, direct model calls, knowledge bases, tools and integrations, inspectors, memory and the REST API.

Start with Koder. To use another coding agent, get the aixplain plugin for Claude Code, or the standalone skill for any compatible host.

Use Koder

Koder is aixplain's coding agent for desktop and terminal. Describe the agent you need, and Koder writes, tests and deploys it with the SDK. You review every change before it lands.

1. Download Koder for macOS (Apple silicon), Windows or Linux. Other builds are on koder.aixplain.com.
2. Sign in with your aixplain account.
3. Describe the agent, for example: "Build an agent that answers questions from our product docs and deploy it."

Install the Claude Code plugin

The aixplain plugin installs two skills that work together:

• Marketplace search: live search of the aixplain Marketplace and the real input schema of each asset.
• aixplain-builder: build, run and deploy agents, models, knowledge bases and tools with the SDK.

In the terminal that starts Claude Code, set your API key:

export AIXPLAIN_API_KEY="YOUR_API_KEY"

Then run these commands at the Claude Code prompt:

/plugin marketplace add aixplain/aiXplain
/plugin install aixplain@aixplain

The plugin reads the key from the environment variable to connect the Marketplace search MCP server. It stores no key in its configuration.

Check that it works:

1. Run /plugin list. The aixplain plugin shows as enabled.
2. Run /mcp. aixplain-marketplace-search shows as connected with its tools. If its tools fail to load with a 403, AIXPLAIN_API_KEY is missing from the terminal that started Claude Code.
3. Type /aixplain:. The aixplain-builder and marketplace-search skills appear.
4. Ask: "Find a web search tool and show me its inputs."

If the plugin does not load, download the skill and install it directly.

Install the standalone skill

The skill does not need Claude Code plugins or MCP. It needs Python, the SDK and AIXPLAIN_API_KEY.

Download the skill (a .skill file: a zip with the same files as the plugin's copy). Add it to Claude as a skill, or unzip it where your host loads skills:

Host	How to install
Claude Code	Copy skills/aixplain-builder/ to ~/.claude/skills/.
Codex	Reference or paste SKILL.md into AGENTS.md, with the files it needs from references/.
Cursor	Add SKILL.md as a rule under .cursor/rules/, with the references it needs.
Copilot or another host	Add SKILL.md and its references with that host's instruction-file convention.

Without Marketplace search, the skill finds assets with SDK search instead.

note

Use the same API key for the SDK, the skill and Marketplace search. Keep it in an environment variable, and never paste it into generated code or commit it.

What you can ask for

Build and deploy an agent:

Build an agent that creates an evidence-backed customer briefing from web research.

The skill plans the agent, confirms it with you before anything that costs credits, scopes each tool to the actions it needs, saves the agent and checks a real run.

Run a model once:

Transcribe this meeting recording and summarize the decisions.

Answer from your documents:

Build a knowledge base from these PDFs and an agent that answers from it.

Update or export an agent:

Update agent YOUR_AGENT_ID to use our Slack integration.
Export agent YOUR_AGENT_ID as portable SDK code.

Give your coding agent the pattern library

The pattern library is a set of minimal, complete SDK patterns for common agents, such as web research, knowledge base, SQL, multi-agent team and governed agents. Give it to your coding agent so it starts from working code:

• raw.txt: all the patterns in one plain-text file. Add it to your coding agent's context or paste it into a prompt.

Safety defaults

• Plans first and asks before it runs anything that spends credits.
• Searches the Marketplace before it hardcodes an asset ID.
• Scopes every tool to the smallest set of actions the task needs.
• Asks for credentials and IDs instead of inventing them.
• Saves, runs and reads the result before it reports success.

Requirements

• Python 3 and pip install --upgrade aixplain. The skill names the SDK version it was checked against in SKILL.md.
• An aixplain API key in the AIXPLAIN_API_KEY environment variable.
• A coding agent that can load skills or instruction files.

To update the skill, pull the skills/aixplain-builder folder again and replace the installed copy. The plugin carries an identical copy.

Next steps

• Quickstart: write your first agent by hand to see what the skill generates.
• Tools: the tools the skill can attach to your agents.
• Agents: every option the skill can set on an agent.