Meta Agent Creator

Meta-Agent Creator

A meta-skill that helps create new specialized agents for multi-agent orchestration systems. Supports Claude Code and OpenCode platforms.

Output Language: All generated agent content (prompts, descriptions) will be in English.

Quick Start

Create a New Agent

# Initialize a new agent
bun scripts/init-agent.ts <agent-name> --path <output-directory> --platform <platform>

# Examples
bun scripts/init-agent.ts security-auditor --path src/agents --platform opencode
bun scripts/init-agent.ts data-analyst --path .claude/agents --platform claude-code

Validate Agent

bun scripts/validate-agent.ts <agent-file>

# Examples
bun scripts/validate-agent.ts src/agents/my-agent.ts
bun scripts/validate-agent.ts .claude/agents/my-agent.ts

Agent Categories

Choose the appropriate category based on agent purpose:

Agent Creation Workflow (5 Phases)

Phase 1: DEFINE PURPOSE

Goal: Clarify agent's role and responsibilities.

Questions to Ask:

1. "What specific tasks should this agent handle?"
2. "When should the orchestrator delegate to this agent?"
3. "What domain expertise is required?"
4. "Should it be read-only or have write access?"

Deliverables:

• Clear role definition
• Trigger conditions for delegation
• Required capabilities list
• Access level decision (readonly vs full)

Phase 2: CLASSIFY

Goal: Determine category and model tier.

Decision Matrix:

Deliverables:

• Category assignment
• Model tier selection
• Cost classification

Phase 3: DESIGN PROMPT

Goal: Write effective system prompt.

Prompt Structure:

## Role

[1-2 sentence identity and expertise]

## Core Capabilities

- [Capability 1]
- [Capability 2]

## Workflow

1. [Step 1]
2. [Step 2]

## Output Format

[Structured output definition]

## Constraints

- [Constraint 1]
- [Constraint 2]

Best Practices:

• Keep prompts concise (<500 words)
• Use imperative form
• Include specific output format
• Define clear constraints

Phase 4: CONFIGURE

Goal: Create platform-specific configuration.

OpenCode / Claude Code (TypeScript)

Location: src/agents/<agent-name>.ts

export function createMyAgent(model: string): AgentConfig {
  return {
    name: "my-agent",
    description: "Agent description...",
    mode: "subagent",
    model,
    temperature: 0.1,
    tools: { include: ["read", "glob", "grep"] },
    prompt: `System prompt...`,
  };
}

Phase 5: REGISTER & TEST

Goal: Add agent to registry and verify functionality.

Registration Checklist:

• Add to agent definitions/index
• Update orchestrator's available agents list
• Add to delegation table if applicable
• Test with sample delegation

Testing:

1. Invoke agent with representative task
2. Verify output format matches spec
3. Check tool restrictions are enforced
4. Test edge cases

Platform Configurations

OpenCode / Claude Code Agent Fields

Common Agent Templates

See references/agent-templates.md for ready-to-use templates:

• Exploration Agent
• Verification Agent
• Debugger Agent
• Security Auditor Agent

Anti-Patterns to Avoid

References

• Agent Templates: See references/agent-templates.md for ready-to-use templates
• Agent Patterns: See ../meta-skill-creator/references/agent-patterns.md for architecture guidance

Converted and distributed by TomeVault — claim your Tome and manage your conversions.