Agent Sorting Hat
Use this skill when an existing agent or agent team feels wrong, overloaded, blurred, under-specified, or misaligned.
This skill is for sorting / alignment / placement.
It is not for final persona polishing, identity-binding, or character-soul refinement.
If the problem is “this agent seems off,” “this team boundary is unclear,” “should this be one agent or three,” or “this role keeps drifting,” use this skill before rewriting persona files.
Use this skill when
Trigger on requests like:
- “This agent feels wrong.”
- “She keeps giving plans but not executing.”
- “This persona and its job seem mismatched.”
- “We need to rebuild this agent.”
- “These agents have blurry boundaries.”
- “Should this be split into multiple roles?”
- “Do we need a new agent, or is the current one just in the wrong position?”
- “Our team structure is off.”
Do not use this skill for
Do not use this skill as the first choice when:
- The user only wants persona refinement, tone reshaping, identity-binding, or stronger character feel.
- Use
ollivanders-agent-shop instead.
- The user wants a brand-new agent from scratch with no role-drift or team-structure question.
- Use the most appropriate creation/persona skill instead.
- The user only wants a small wording tweak to one file.
- Edit directly if no deeper role problem exists.
Core rule
Diagnose placement before personality.
Do not jump into persona rewriting until you have checked whether the real problem is:
- Role misalignment — the agent is in the wrong job.
- Team gap — one agent is covering too many incompatible responsibilities.
- Operating problem — the role is correct, but the workflow, subagent use, delegation judgment, or output pattern is broken.
- Persona problem — the role is correct, but the tone, identity, or character grounding is weak.
Use this order strictly:
- Role misalignment
- Team gap
- Operating problem
- Persona problem
Required workflow
Follow these steps in order.
1. Read the current role context
Read only the files needed to understand the current situation, typically:
- the target agent’s role/persona files
- any relevant team/proposal docs
- any current-team-state or registry documents
- one or two strong comparison examples, if relevant
2. Identify the task chain
Determine the actual work chain behind the problem.
Typical chain examples:
- research / analysis
- design / strategy
- execution / production
- audit / risk
- quality control
- coordination / integration
Do not start by asking “who is this character?”
Start by asking: what work chain is actually happening here?
3. Diagnose the problem type
Classify the issue into one or more of:
- role misalignment
- team gap
- operating problem
- persona problem
State clearly which one is primary.
4. Decide whether to keep, split, merge, or reserve
For each affected role, determine whether it should:
- stay where it is
- move to a different role position
- split into two or more roles
- merge with another role
- become a reserved capability instead of an instantiated agent
5. Redesign the team placement
Produce a cleaner role map that explains:
- who owns which stage
- what each role is responsible for
- what each role is not responsible for
- what the handoffs are
- which roles are long-term, stage-based, or reserved
6. Update the rewrite order
Before editing files, determine the correct order of change.
Usually:
- proposal / team-level docs
- current team state
- target role files
- downstream linked roles
- persona refinement only if still needed
7. Only then refine persona files
After placement is correct, refine the target agent’s files.
If the role still needs deeper persona grounding after placement is fixed, hand off to ollivanders-agent-shop.
Output requirements
Your output should include all of the following.
A. Diagnosis
State:
- the primary problem type
- any secondary problem types
- why you made that diagnosis
B. Role alignment result
State:
- which roles should remain
- which roles should move
- which roles should split
- which capabilities should remain reserved for now
C. Team structure result
State clearly:
- each role’s one-line position
- each role’s core responsibility
- each role’s non-responsibility
- handoff directions between roles
D. Change plan
State:
- which docs should change first
- which role files should change next
- whether persona refinement is still needed afterward
Good sorting behavior
Do:
- keep the team as small as possible while preserving clarity
- prefer role clarity over role quantity
- preserve good existing roles when possible
- treat “reserve, don’t instantiate yet” as a valid outcome
- distinguish structure problems from personality problems
Do not:
- assume more agents is always better
- rewrite persona first when the role is wrong
- create a new role just because a task feels messy
- confuse “strong character flavor” with “good team placement”
Relationship to other skills
agent-sorting-hat
Use for:
- role alignment
- team restructuring
- capability splitting/merging
- deciding placement and boundaries
- determining whether a role should exist, move, split, or stay reserved
ollivanders-agent-shop
Use for:
- persona shaping
- identity-binding
- character grounding
- making the role feel right after its placement is correct
Recommended order:
agent-sorting-hat to put the role in the right placeollivanders-agent-shop to make the role deeply itself
Minimal mental model
- Sorting Hat decides where the role belongs.
- Ollivanders helps the role hold the right wand.
Placement first. Soul refinement second.
