# Iblai Agent Create

> Create a new ibl.ai agent from a template via the platform API — set name, display name, description, system prompt, and LLM provider; returns the new agent's unique id. Use when creating an agent from scratch, then configure it with the other /iblai-agent-* skills.

- **Type:** Skill
- **Install:** `agentstack add skill-iblai-api-iblai-agent-create`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [iblai](https://agentstack.voostack.com/s/iblai)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [iblai](https://github.com/iblai)
- **Source:** https://github.com/iblai/api/tree/main/skills/iblai-agent-create
- **Website:** https://ibl.ai/join

## Install

```sh
agentstack add skill-iblai-api-iblai-agent-create
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# iblai-agent-create

Create a brand-new agent from a template. This is the step **before**
configuring an agent: it mints a new agent and returns its `unique_id`, which
you then hand to the `/iblai-agent-*` skills (settings, llm, prompts,
datasets, …) to configure further. To duplicate an existing agent instead of
starting from a template, use `/iblai-agent-settings` (fork).

## Auth & conventions

- **Base URL:** `https://api.iblai.app`
- **Header:** `Authorization: Api-Token $IBLAI_API_KEY` on every request.
- **Path vars:** `{org}` = `$IBLAI_ORG`, `{username}` = `$IBLAI_USERNAME`.
- Not connected yet? Run **`/iblai-login`** first to populate `IBLAI_ORG`,
  `IBLAI_USERNAME`, and `IBLAI_API_KEY`.

## Reads

- **GET** `https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/mentors/` — list existing agents in the org (useful to pick a fork source or confirm names are free).
- **GET** `https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentor/categories/` — category options (to assign after creation via `/iblai-agent-settings`).

## Writes

- **POST** `https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentor-with-settings/` — create a new agent from a template (returns the created agent with its `unique_id`):
  ```json
  {
    "template_name": "string (required, e.g. ai-mentor)",
    "new_mentor_name": "string (required)",
    "display_name": "string",
    "description": "string",
    "system_prompt": "string",
    "llm_provider": "string"
  }
  ```

## Example

Create a data-science agent from the default `ai-mentor` template, then capture
its `unique_id` for follow-up configuration:

```bash
curl -X POST \
  "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentor-with-settings/" \
  -H "Authorization: Api-Token $IBLAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "ai-mentor",
    "new_mentor_name": "Data Science Tutor",
    "description": "Helps users with statistics and Python."
  }'
# → response includes "unique_id"; use it as {mentor} in the other skills
```

## Notes

- `template_name` defaults to `ai-mentor` on most orgs; the create call accepts
  any template the org exposes.
- Creation is intentionally minimal — set only name + a couple of fields here,
  then drive the rest with the focused skills: `/iblai-agent-settings`,
  `/iblai-agent-llm`, `/iblai-agent-prompts`, `/iblai-agent-datasets`,
  `/iblai-agent-tools`, etc., using the returned `unique_id` as `{mentor}`.
- To copy an existing agent rather than start from a template, use the **fork**
  endpoint in `/iblai-agent-settings`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [iblai](https://github.com/iblai)
- **Source:** [iblai/api](https://github.com/iblai/api)
- **License:** MIT
- **Homepage:** https://ibl.ai/join

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-iblai-api-iblai-agent-create
- Seller: https://agentstack.voostack.com/s/iblai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.