#Specialist Builder Overview

The specialist builder lets you create custom AI agents tailored to your team's needs. You define a persona, give it knowledge, wire up tools, and publish it to your workspace. The builder also includes an AI chat assistant that helps you refine the specialist as you go.

#Getting Started

From the Specialists page, click the + button to create a new specialist. The builder opens with a blank slate ready for configuration.

#Builder Layout

The builder is split into two panels.

The chat panel on the left is an AI assistant that helps you build and test the specialist. It has two modes:

• Build. The assistant suggests improvements, asks clarifying questions, and helps fill in configuration fields.
• Test. The assistant simulates conversations so you can verify how the specialist behaves before publishing.

The tabbed editor on the right is where the actual configuration lives. Six tabs organize every aspect of the specialist:

1. Persona. Name, role, purpose, audience, values, attributes, tech stack, and writing style.
2. Tasks & Workflows. What the specialist can do and how it handles common requests.
3. Knowledge. Documentation, URLs, and files the specialist draws on for grounded responses.
4. Tooling. Built-in tools, MCP servers, and tool patterns the specialist can use.
5. Benchmarks. Automated quality tests that validate the specialist's behavior.
6. Review & Publish. Final review, scope selection, model configuration, and publishing.

For details on tabs 2 through 5, see Builder Tab Details.

#The Persona Tab

The Persona tab is where you define who the specialist is. It has seven sections:

• Role. A short title like "Senior Frontend Engineer" or "Technical Writer."
• Purpose. A sentence or two describing the specialist's primary goal.
• Audience. Who the specialist is built for. You can set a primary audience, secondary audience, and assumptions about what users already know.
• Values. Core principles that guide the specialist's behavior. You can use simple free-text values or structured entries with descriptions.
• Attributes. Personality traits and behavioral characteristics.
• Tech Stack. Languages, frameworks, and tools the specialist knows about.
• Writing Style. Controls for tone, verbosity, formality, reading level, jargon level, secondary tone, and style modifiers.

All fields save in real time as you type.

#The Review & Publish Tab

When you are ready to share your specialist, open the Review & Publish tab. It includes:

• AI-generated overview. A description, a "what it does" bullet list, and example prompts. The builder generates these automatically based on your configuration.
• Publish scope. Choose between Workspace (everyone in the workspace can use it) or Personal (only you).
• Preferred model. Select the default AI model the specialist should use.
• Prompt authoring. Write the default system prompt, add model-specific overrides, and configure per-task prompts with model variants and knowledge targeting.

Publishing is gated by the Specialist IQ score. Your specialist must reach a score of at least 40% before you can publish.

#Specialist IQ

Specialist IQ is a quality score from 0 to 100 that measures how complete and well-configured your specialist is. The score is broken down across five dimensions:

• Knowledge. Has the specialist been given relevant documentation and context?
• Tasks. Are tasks defined with clear descriptions and examples?
• Tone. Is the writing style configured?
• Purpose. Is the role and purpose clearly stated?
• Benchmarks. Have quality tests been created and passed?

As you fill in the builder, the IQ score updates in real time. The status labels are:

#The Middle Tabs

The four tabs between Persona and Review & Publish contain the bulk of the specialist's configuration. See Builder Tab Details for a walkthrough of Tasks & Workflows, Knowledge, Tooling, and Benchmarks.

#Next Steps

• Builder Tab Details. Deep dive into the Tasks, Knowledge, Tooling, and Benchmarks tabs.
• Model Overrides. Configure which AI model the specialist uses at the workspace or personal level.
• Working with Specialists. See how the finished specialist behaves in a real conversation.