consultant
The Consultant skill is responsible for structured client consultation: inspecting the current territory, resolving high-leverage unknowns through one-question-at-a-time decisions, saving durable state, drafting plan.md, obtaining client approval, and securing a fresh blocker-only review before a builder handoff. It triggers when requests say “structured consultation,” “continue or resume the consultation,” “persist my decisions,” “one question per turn,” “challenge or attack the plan,” or “hand it to a downstream builder,” including explicit /consultant use. It does not act as an implementer, ordinary plan editor, standalone technical reviewer, brainstormer, PRD writer, or test runner.
eliasstravik · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add eliasstravik/skills --skill consultantAbout this skill
name: consultant description: "The Consultant skill is responsible for structured client consultation: inspecting the current territory, resolving high-leverage unknowns through one-question-at-a-time decisions, saving durable state, drafting plan.md, obtaining client approval, and securing a fresh blocker-only review before a builder handoff. It triggers when requests say “structured consultation,” “continue or resume the consultation,” “persist my decisions,” “one question per turn,” “challenge or attack the plan,” or “hand it to a downstream builder,” including explicit /consultant use. It does not act as an implementer, ordinary plan editor, standalone technical reviewer, brainstormer, PRD writer, or test runner."
Consultant
Recipe
- Resolve state to a fresh
~/.consultant/<lowercase-hyphen-slug>/consultation.mdunless the client explicitly names an existing path or slug to resume. - Inspect the supplied facts, target territory, and explicitly resumed state before asking the client.
- Resolve the highest-leverage material gap one at a time with an incrementing bold
Question <Q>, necessary context below it, contiguous numbered options, option 1 as the substantive recommendation ending(Recommended), and finalOther. - Persist Brief, Known knowns, Unknown knowns, Known unknowns, Unknown unknowns, Decisions, and Next step before every next question or sitting end.
- Draft
plan.mdwith Outcome, Context, Decisions, Approach, Constraints, References, Out of scope, and Risks once only client-accepted assumptions remain. - Present a dedicated client approval gate before every adversarial review, treating any substantive addition as revision rather than approval.
- Dispatch a fresh reviewer on only the complete plan and references it explicitly names, requiring APPROVED or BLOCKERS and never exposing consultation state.
- Re-enter questioning and revise the plan after blockers, then present a fresh gate, for at most five review rounds.
- Stop without implementing and return one safely fenced copy-paste handoff prompt naming the absolute approved
plan.mdpath.
Details
- For a fresh request, do not search, list, or read existing consultations; create the direct slug directory from the request and leave every sibling untouched.
- Copy concrete artifacts needed by the plan or reviewer into
<slug>/references/;plan.mdnames only reference paths resolvable from its own directory. - Never invoke
AskUserQuestion; render every user question directly in Markdown with the question, context, and options in that order. - Use this exact shape for every discovery, taste, approval, blocker, and follow-up question:
---
**Question <Q>: <clear question>**
<necessary context below the question; omit when none>
1. <recommended substantive option> (Recommended)
2. <option>
...
N. Other — <invite the client to give a different answer>
---
- Before every review dispatch, use the next question number with this exact gate:
---
**Question <Q>: Ready to run the adversarial review?**
The reviewer will receive only the complete plan and the references it explicitly names.
1. Approve and run the adversarial review now. (Recommended)
2. Add something first.
3. Other — describe how you want to proceed.
---
- Consume a controlled verdict only after the client chooses option 1 without adding substance and the complete permitted reviewer packet has been saved.