> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-homepage-20260719-015142.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an Agent

> Use a coding-agent skill to create and verify an agent.

The codebase keeps agent code and eval cases in one repository, and the local runtime exposes logs, traces, and live behavior. A coding agent can use this context to create and verify new agents for you.

There are two ways to create an agent:

| You want                               | Use                             |
| -------------------------------------- | ------------------------------- |
| Agent source stored in the repository  | `create-new-agent` skill        |
| Agent configuration stored in Postgres | Agent Builder in the AgentOS UI |

## Run the skill

Open your coding agent in the `agent-platform` directory and ask it to run:

```text theme={null}
Run the create-new-agent skill in .agents/skills.
```

Give the coding agent a clear brief and it starts building. For an open-ended goal, it asks for the context it needs to choose the pattern and tools.

Once the specification is clear, it generates `agents/<slug>.py`, registers the agent in `app/main.py`, adds quick prompts to `app/config.yaml`, restarts the container, and smoke-tests the live endpoint.

## Test your agent on the AgentOS UI

Open [os.agno.com](https://os.agno.com), click **Refresh**, choose your new agent from the **Agents** dropdown, 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-new-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 quick prompts 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)