Skip to main content

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
Headmaster ships with 20+ built-in specialists. You can also hire custom specialists from scratch.

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”
Editing flow:
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

Best practices:
  • ✏️ 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 as SKILL.md documents loaded on demand. Adding skills:
  1. Open the specialist → Skills section.
  2. Toggle existing skills on/off with checkboxes.
  3. To add custom skills, click Add skills and pick a path or paste an absolute path.
See Skills & The Agency for the full skills documentation.

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

Backend: Built-in agent
Backend: Claude Code or built-in agent
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.