Home / Agents / Agent Creator

🧙 Agent Creator Wizard

The Agent Creator is an interactive wizard that helps you create custom agents without writing JSON by hand.

Getting Started

Switch to the agent creator:

/agent agent-creator

Using the Wizard

Simply describe what kind of agent you want to create:

💬 Example Prompts
  • "I need an agent that reviews database schemas and suggests optimizations"
  • "Create an agent for writing API documentation"
  • "I want an agent that helps with Kubernetes configurations"
  • "Make an agent for reviewing React components"

Step-by-Step Walkthrough

Step 1: Describe Your Agent

/agent agent-creator

> I need an agent that reviews database schemas and 
suggests performance optimizations

Step 2: Answer Questions

The wizard will ask clarifying questions:

🧙 What database systems should this agent focus on?

> PostgreSQL and MySQL primarily, but it should 
understand general SQL principles

Step 3: Review Generated Config

The wizard generates a complete agent configuration:

{
  "id": "db-schema-reviewer-12345",
  "name": "db-reviewer",
  "display_name": "Database Schema Reviewer 🗺️",
  "description": "Reviews database schemas for performance...",
  "system_prompt": "You are a database expert...",
  "tools": ["list_files", "read_file", ...]
}

Step 4: Confirm and Save

The wizard saves the agent to ~/.code_puppy/agents/

Step 5: Use Your Agent

/agent db-reviewer

# Now you can use your new agent!
> Review the schema in migrations/001_users.sql

Tips for Better Agents

🎯 Best Practices
  • Be specific - Describe the exact problem domain
  • Mention technologies - List specific languages, frameworks, tools
  • Describe personality - Should it be formal? Friendly? Strict?
  • Define scope - What should it do? What shouldn't it do?
  • Include examples - Give example use cases

Example Agent Ideas

Documentation Writer

"Create an agent that writes technical documentation.
It should understand JSDoc, Python docstrings, and 
Markdown. It should be thorough but concise, and 
always include code examples."

Git Commit Helper

"I want an agent that helps write git commit messages.
It should follow conventional commits format, be 
concise, and explain the 'why' not just the 'what'."

API Design Reviewer

"Create an agent for reviewing REST API designs.
It should check for RESTful principles, proper HTTP 
methods, good naming conventions, and security 
considerations."

Editing Existing Agents

To edit an agent, find its JSON file in ~/.code_puppy/agents/ and modify it directly, or ask the agent creator:

"Modify my db-reviewer agent to also check for 
proper indexing strategies"

Next Steps