# Agent Creator

> Create new OpenCode agents with a gpt-5.2-codex default.

- Skill: `allura-ecosystem/agent-creator` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add allura-ecosystem/agent-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/allura-ecosystem/agent-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Allura-Ecosystem (https://skillmd.com/u/allura-ecosystem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/allura-ecosystem/agent-creator

---


## Quick Usage (Already Configured)

### Create a project agent
```bash
opencode agent create
```

### Agent file locations
- Project agents: `.opencode/agents/<name>.md`
- Global agents: `~/.config/opencode/agents/<name>.md`

## Default model

Use `gpt-5.2-codex` as the default model for new agents unless a workflow needs a different model.

## Minimal agent template

```markdown
---
description: One-line description of what the agent does
mode: subagent
model: gpt-5.2-codex
tools:
  write: false
  edit: false
  bash: false
---
You are a specialized agent. Describe your task, boundaries, and expected output.
```

## Notes from OpenCode docs

- Agent files are markdown with YAML frontmatter.
- The markdown filename becomes the agent name.
- Set `mode` to `primary`, `subagent`, or `all`.
- If no model is specified, subagents inherit the caller model.
- `tools` controls per-agent tool access.

## Reference

Follow the official OpenCode agent docs: https://opencode.ai/docs/agents/

## First-Time Setup (If Not Configured)

1. Run `opencode agent create` and choose project scope.
2. Paste in the default template above and adjust tools as needed.