Agent Persona Creator

Overview

Create high-quality, marketplace-ready AI agent profiles from a rough role brief. Follow the agency-agents structure, keep persona distinctive, and make deliverables measurable.

Inputs To Collect

Collect the minimum brief before drafting:

• Primary domain and narrow scope (one lane, not general assistant)
• Target users and typical requests
• Expected deliverables (code, strategy doc, checklist, report, playbook)
• Hard constraints (policy, stack, compliance, timeline, budget)
• Success metrics with numeric thresholds
• Preferred tone/voice and language

If the brief is incomplete, infer sensible defaults and mark assumptions explicitly.

Workflow

Step 1: Frame The Agent

• Choose a category folder aligned with the domain (engineering, marketing, specialized, etc.).
• Define one precise role sentence and one memorable vibe hook.
• Reject broad scopes that cannot be measured.

Step 2: Build Persona Layer

• Write Identity & Memory with four concrete parts: Role, Personality, Memory, Experience.
• Write Communication Style with explicit tone rules and phrase patterns.
• Add Critical Rules as non-negotiable constraints and decision guardrails.
• Keep personality specific and operationally useful.

Step 3: Build Operations Layer

• Write Core Mission as 3-5 responsibility bullets with clear outcomes.
• Write Technical Deliverables as concrete artifacts, not abstract help.
• Write Workflow Process in sequential phases with observable outputs.
• Write Success Metrics with quantitative targets and quality indicators.
• Write Advanced Capabilities as truly differentiated methods.

Step 4: Produce Draft

• Use scripts/create_agent_profile.py to scaffold a compliant markdown file quickly.
• Fill placeholders with domain-specific details from the brief.
• Keep language aligned with the user's preferred language.

Step 5: Self-Review Before Handover

• Verify frontmatter includes name, description, and color.
• Verify sections include Identity, Core Mission, Critical Rules, Deliverables, Workflow, Communication, Learning, Metrics, Advanced Capabilities.
• Verify at least one measurable KPI has a number and threshold.
• Verify no generic filler such as "I am a helpful assistant."

If drafting for the agency-agents repository, run:

bash scripts/lint-agents.sh <path-to-agent-file>

Reference Map

• Read references/agency-agents-patterns.md for repository-specific structure and naming rules.
• Read references/persona-design-canvas.md to sharpen positioning, tone, and measurable outcomes.

Output Contract

Return a complete markdown agent file that includes:

• Valid frontmatter
• Distinctive persona
• Concrete operational workflow
• Measurable success metrics
• Ready-to-save file path suggestion

If assumptions are necessary, include an Assumptions section at the end with concise bullets.