> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an Agent

> Use Claude Code to create a new agent.

Next we're going to create a new agent using Claude Code.

Because code, data, and logs live in one place, coding agents can manage the platform end to end. The codebase ships eight skills for setup, development, evals, review, and deployment.

Run `/create-agent`.

## Run the skill

Open Claude Code (or your favorite coding agent) in your `agent-platform` directory and run:

```text theme={null}
/create-agent
```

Claude gathers any missing details, then builds your agent.

Once the spec is complete, Claude generates `agents/<slug>.py`, registers it in `app/main.py`, adds a description and three quick prompts to `app/config.yaml`, restarts the container, and smoke-tests it live.

## Test your agents on the AgentOS UI

Open [os.agno.com](https://os.agno.com), select your new agent in the sidebar, and try a few prompts:

* **The golden path.** What you built the agent for.
* **Edge cases.** Unusual inputs, ambiguous questions, partial information.
* **Adversarial inputs.** Prompt injection, out-of-scope requests, attempts to make it do something it shouldn't.

## Do it manually

The `/create-agent` skill automates the agent creation process. To do it manually:

* Create a file in `agents/<slug>.py`.
* Register the agent in `app/main.py`.
* Add its description and three quick prompts under `manifest.<id>` in `app/config.yaml`.

The agent file skeleton and the `app/main.py` registration are in [Railway Reference](/deploy/templates/railway/reference), under "Add an agent".

## Next

[Improve the agent →](/agent-platform/improve-agent)