advisor — Claude Code skill: what it does, how to install
Adds a second model for reviewing decisions, debugging dead ends, and checking work before completion. The mode starts only when explicitly requested.
npx skills add cursor/plugins --skill advisor -a claude-codeWhat advisor does
advisor brings in a separate model as a consultant during an agent task. It receives a briefing and returns guidance, while the main agent keeps responsibility for file edits and the final decision.
Use /advisor to turn the mode on, pass a model name to select one, or call /advisor ask <question> for an immediate opinion. Consultations are intended before consequential choices, after repeated failed fixes, and before wrapping up non-trivial work. Its state is kept in .cursor/advisor/state.json.
Full mode requires a model available to subagents. Check the available subagent models before naming one, because an unavailable slug is replaced with the closest available option.
What it helps with
- get a second opinion before an architecture change
- investigate an error after repeated failed fixes
- review work before reporting a task complete
- select a consultant model for a subagent
Example prompts for the agent
/advisor/advisor cursor-grok-4.6-xhigh-fast/advisor ask Review my API change plan
How to install advisor
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill advisor -a claude-code2Manually: put the files in place
~/.claude/skills/advisor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/advisor/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill advisor -a codex2Manually: put the files in place
.agents/skills/advisor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cursor/plugins --skill advisor -a cursor2Manually: put the files in place
.cursor/skills/advisor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cursor/plugins advisor2Manually: put the files in place
.github/skills/advisor/SKILL.md1Skills CLI (Vercel)
npx skills add cursor/plugins --skill advisor -a gemini-cli2Platform CLI
gemini skills install https://github.com/cursor/plugins --path advisor/skills/advisorManually: put the files in place
.devin/skills/advisor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cursor/plugins --skill advisor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about advisor
How do I install advisor in Claude Code?
Run npx skills add cursor/plugins --skill advisor -a claude-code, then run npx skills add cursor/plugins --skill advisor -a claude-code again. The skill file is placed at ~/.claude/skills/advisor/SKILL.md.
What does advisor do?
It adds a consultant model at selected checkpoints in an agent task. The consultant gives guidance but does not edit files or make the final call.
Where does advisor keep its mode state?
Mode settings are stored in .cursor/advisor/state.json. /advisor off removes the .cursor/advisor/ directory.