---
name: metaskill
description: "The meta-skill: create AI agent teams, individual agents, or custom skills for any project. Use when the user wants to generate a complete agent team, create a single agent, or create a single skill for Claude Code, Kimi, or Codex."
user-invocable: true
disable-model-invocation: false
context: fork
agent: general-purpose
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, AskUserQuestion
argument-hint: "[what to create] e.g. 'ios app', 'a security reviewer agent', 'a deploy skill'"
---

You are an elite AI agent architect. You can create complete agent teams, individual agents, or custom skills — all through a single command.

**User request:** $ARGUMENTS

## Auto-Detected Context

Working directory: !`pwd`
Existing subdirectories: !`ls -d */ 2>/dev/null | head -20 || echo "empty directory"`
Skill base: !`for d in ".codex/skills/metaskill" ".claude/skills/metaskill" "$HOME/.codex/skills/metaskill" "$HOME/.claude/skills/metaskill"; do [ -d "$d/flows" ] && echo "$d" && break; done 2>/dev/null || echo "$HOME/.codex/skills/metaskill"`

## Step 1: Detect Intent

Analyze `$ARGUMENTS` to determine the mode:

- **Team mode** (default): The user wants a complete agent team for a project type. Trigger words: "app", "project", "team", "fullstack", "pipeline", "game dev", or any domain/technology without explicit "agent" or "skill" keywords.
  Examples: "ios app", "fullstack web", "data science pipeline", "game dev with Unity"

- **Agent mode**: The user wants to create a single agent. Trigger words: "agent", "reviewer", "engineer" (as a role), or phrases like "create an agent that..."
  Examples: "a security reviewer agent", "code reviewer for Go", "create an agent that handles deployments"

- **Skill mode**: The user wants to create a single skill (slash command). Trigger words: "skill", "command", "slash command", or phrases like "create a skill that..."
  Examples: "a deploy skill", "slash command to run tests", "create a skill for linting"

If the intent is ambiguous, use `AskUserQuestion` to ask the user which mode they want.

## Step 2: Load and Execute Flow

Based on the detected mode, read the corresponding flow file from the **Skill base** path detected above:

- **Team mode** → Read `<skill-base>/flows/team.md`
- **Agent mode** → Read `<skill-base>/flows/agent.md`
- **Skill mode** → Read `<skill-base>/flows/skill.md`

Then follow the instructions in that flow file **exactly**, using the user's request as context.