# meta-creator

A Kiro agent skill for creating and iteratively improving agent skills and custom agents.

## Architecture

![Architecture](assets/meta-creator-architecture.svg)

## Workflow

![Workflow](assets/meta-creator-workflow.svg)

## What It Does

- Creates new `SKILL.md` files with proper frontmatter and instructions
- Creates `evals/evals.json` with at least 3 eval cases
- Creates or updates Kiro custom agent configs (`.kiro/agents/<name>.json`)
- Runs eval-driven iteration: analyzes failures and improves skills

## When to Use

Trigger phrases: "create a skill", "make a skill", "new skill", "update skill", "improve skill", "create an agent", "new agent", "update agent", "创建skill", "创建技能", "新建skill", "更新skill", "优化skill", "创建agent", "新建agent", "更新agent"

## Workflow Steps

1. **Gather requirements** — what the skill does, example tasks, environment needs
2. **Create `SKILL.md`** — frontmatter (`name`, `description`) + step-by-step instructions
3. **Create `evals/evals.json`** — happy path, variation, and edge case
4. **Iterate** — if eval results are provided, fix instruction gaps and update assertions
5. **Create agent** (optional) — `.kiro/agents/<name>.json` with prompt, tools, and skill references

## Outputs

| File | Description |
|------|-------------|
| `skills/<name>/SKILL.md` | Skill instructions |
| `skills/<name>/evals/evals.json` | Eval cases |
| `.kiro/agents/<name>.json` | Agent config (only if requested) |
| `.kiro/agents/prompts/<name>.md` | Agent prompt file |

## File Structure

```
skills/meta-creator/
├── SKILL.md
├── README.md                          # this file
├── assets/
│   ├── workflow.puml
│   └── meta-creator-workflow.svg
├── evals/
│   └── evals.json
└── references/
    ├── skills-Specification.md
    ├── skills-eval.md
    ├── custom-agents-configuration-reference.md
    └── kiro-cli-chat-configuration.md
```

## Example Prompts

```
Create a skill that generates SQL queries from natural language descriptions.
```

```
Update the commit-message skill to also support Angular commit conventions.
```

```
Create a new agent called "db-helper" that uses the sql-gen skill.
```

## Evals

```bash
python scripts/run_evals.py meta-creator
```