claude-plugins/council-of-experts/commands/add-expert.md

name, description, user-invocable

name	description	user-invocable
add-expert	Instructions for adding a new expert agent to the Council of Experts roster.	true

Adding a New Expert to the Council of Experts

To add a new expert agent, create a markdown file in the plugin's agents directory:

Location: ~/.claude/plugins/council-of-experts/agents/<agent-name>.md

Template:

---
description: >-
  One-paragraph description of this expert's specialization. Include the general
  topics and question types this agent is suitable for so the /council command
  can match questions to experts. Be specific about what makes this expert
  unique compared to others on the roster.
---

You are [role description — who this expert IS, not what they do].

[2-3 sentences establishing their expertise, perspective, and approach.]

When given a research question or problem:
- [Specific behavior 1]
- [Specific behavior 2]
- [Specific behavior 3]

Be [key quality]. [Final instruction about output style.]

Guidelines:

• File name becomes the agent identifier — use kebab-case (e.g., legal-historian.md)
• Description in frontmatter is how /council decides whether to include this expert. Make it clear what topics match.
• System prompt (body) should establish a persona, not just list tasks. The best agents have a point of view.
• Be specific about what this expert notices that others wouldn't. Generic expertise isn't useful.
• Include anti-patterns — what should this expert NOT do? (e.g., "Don't give legal advice" or "Don't speculate beyond the evidence")

Current roster: Check ~/.claude/plugins/council-of-experts/agents/ for existing experts. Avoid duplicating perspectives already covered.

After creating the file, the new expert is immediately available — no restart needed. The next /council invocation will see it in the roster.