Specialists
A specialist is a focused AI persona built on top of an agent backend. It bundles:- Backend agent — runs the work (built-in engine, Claude Code, Codex, Gemini CLI, etc.)
- Rules — a Markdown system prompt defining behavior
- Skills — extra capabilities (decks, spreadsheets, reports, MCP tools, etc.)
- Display metadata — name, avatar (emoji or built-in icon), description
The 20+ built-in Specialists
What makes a specialist
- 🖥️ Local-first — runs on your machine. Rules are stored as Markdown files under the data directory.
- 🔌 Pluggable backend — every specialist can pick its own agent (built-in, Claude Code, Codex, etc.).
- 🎛️ Customizable — built-in specialists allow tweaking backend, rules, skills, and description.
- 🧩 Stackable skills — multiple skills can be enabled at once. Skills can be built-in, user-imported, or extension-contributed.
Picking a specialist
Click the specialist picker next to the model selector at the bottom of the composer. A dropdown shows all 20+ specialists with their roles. You can also type/specialist <name> in the composer — e.g., /specialist The Builder.
Hiring a custom specialist
1
Open Your Hires
Go to Settings → My Headmaster → Your Hires.
2
Click Hire a Specialist
Fill in the form.
3
Fill in the fields
4
Save
The specialist appears in the picker immediately.
Available backends match what’s detected on your machine. The built-in engine is always available with no install required.
Configuring rules
Rules are the specialist’s system prompt — Markdown stored as.md files in the data directory. Fed to the backend agent as system instructions at runtime.
Good for:
- 🔁 Workflows — “When the user asks for X, do A, then B, then C”
- 🚧 Constraints — “Never modify files outside the project root”
- 📚 Domain context — “This codebase uses Bun + Vite; tests are Vitest”
- 🎨 Output style — “Always answer in Markdown with a TL;DR at the top”
1
Open the specialist
Go to the specialist in Settings and open the Rules section.
2
Edit the Markdown
Use the Edit tab to write Markdown. Use the Preview tab to see the rendered output.
3
Save
Applies on the next conversation.
Example rule file
- ✏️ Be explicit — short imperative sentences work best.
- 📋 Use headings and bullet lists; agents pay attention to structure.
- 💡 Provide concrete examples for cases you care about.
- 🚫 Don’t dump large reference docs into rules — use Skills for that.
Configuring skills
Skills extend specialists with packaged capabilities — file format processors, document generators, MCP tool bundles, domain-specific reference packs. Stored asSKILL.md documents loaded on demand.
Adding skills:
- Open the specialist → Skills section.
- Toggle existing skills on/off with checkboxes.
- To add custom skills, click Add skills and pick a path or paste an absolute path.
Editing and deleting specialists
Specialist vs. model
A specialist is a role with a personality and skill set. A model is the underlying LLM. You can use any specialist with any model — The Builder with Claude, The Builder with GPT-4o, The Builder with a local Qwen model. The specialist defines approach; the model defines reasoning capability.Use cases
File management specialist
File management specialist
Backend: Built-in agent
Code review specialist
Code review specialist
Backend: Claude Code or built-in agent
Research specialist
Research specialist
Backend: Built-in agent with web search enabled
Skills & The Agency
Install community skills and author your own.
The Council
Run multiple specialists in parallel on complex tasks.