This skill should be used when Claude is facing complex architectural decisions, is stuck on a problem and going in circles, needs validation before investing significant effort, is dealing with trade-off analysis between multiple approaches, or needs an unbiased outside perspective. Guides effective collaboration with the strategist agent who provides expert advice without codebase access.
When facing complex architectural decisions, trade-offs, or going in circles on a problem, this skill guides you to consult an unbiased strategist agent who provides expert advice without codebase access. It helps you prepare context effectively and translate strategic recommendations into actionable solutions for your specific situation.
/plugin marketplace add qduc/claude-skills/plugin install advisor-skills@qduc-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
references/consultation-examples.mdThis skill provides guidance for effectively collaborating with the strategist agent—a remote expert who offers unbiased, objective advice on complex problems but cannot access the codebase directly.
The strategist operates as an experienced consultant working from a remote location:
What the strategist brings:
What the strategist lacks:
Consult the strategist when:
| Situation | Example |
|---|---|
| Architecture decisions | Choosing between monolith vs microservices, selecting a database strategy |
| Multiple valid approaches | Several solutions exist, unclear which is best for the context |
| Going in circles | Tried multiple approaches, keep hitting walls |
| Need validation | Want to verify an approach before significant investment |
| Trade-off analysis | Evaluating pros/cons of different technical choices |
| Problem decomposition | Complex problem needs breaking into manageable pieces |
| Risk assessment | Identifying potential issues before committing |
| Too close to the problem | Lost objectivity, need fresh eyes |
Do not consult the strategist for:
Since the strategist cannot see the code, provide context effectively:
Transform code-specific issues into conceptual descriptions:
Instead of: "The UserService.authenticate() method is calling TokenManager.validate() which queries the database on every request"
Write: "Authentication validates tokens by hitting the database on every request, causing performance issues under load"
List non-negotiable constraints:
Describe previous attempts and why they failed:
End with a specific question:
Include relevant context without overwhelming:
Use the Task tool to consult the strategist:
Task tool:
subagent_type: "advisor-skills:strategist"
prompt: [Your prepared context and question]
description: "Strategic advice on [topic]"
Task tool:
subagent_type: "advisor-skills:strategist"
description: "Architecture advice on caching"
prompt: |
Problem: Our API response times degrade significantly under load because
we validate authentication tokens against the database on every request.
Constraints:
- 3-person team, limited DevOps expertise
- Must maintain current security guarantees
- Cannot add significant infrastructure complexity
Tried:
- Simple in-memory cache, but token revocation became inconsistent
- Considered Redis, but team lacks operational experience
Question: What caching strategies should we evaluate for token validation
that balance performance, security, and operational simplicity?
The strategist provides frameworks and options, not implementation specs. Their advice must be adapted to local reality.
Before implementing strategist recommendations:
The strategist doesn't know about:
Modify recommendations to fit these realities.
If strategist advice conflicts with codebase reality:
1. Encounter complex decision or get stuck
2. Recognize this is a good fit for strategist consultation
3. Prepare context (summarize problem, state constraints, frame question)
4. Invoke strategist agent with prepared context
5. Receive strategic advice and frameworks
6. Validate advice against actual codebase
7. Adapt recommendations to local constraints
8. Implement the adapted solution
For complex problems, multiple rounds may be needed:
Round 1: Frame the problem, get initial direction Round 2: Share what was discovered while implementing, refine approach Round 3: Validate final solution design
Keep each consultation focused on a specific question rather than trying to solve everything at once.
Good: "Choosing between event-driven and request-response patterns for service communication. Team has 5 engineers, mostly synchronous experience. System handles 10K requests/minute with occasional spikes to 50K."
Poor: "How should our services communicate?" (too vague, no context)
Good: "What factors should drive the decision between patterns A and B given our constraints?"
Poor: "Which is better, A or B?" (asks for prescription without context)
Good: "The strategist suggested caching with TTL-based invalidation. However, our system has strict consistency requirements for token revocation. How might we balance cache performance with immediate invalidation needs?"
Poor: "That won't work." (no explanation of why)
The strategist complements, not replaces, direct problem-solving:
For detailed examples and advanced patterns, consult:
references/consultation-examples.md - Extended examples of effective strategist consultationsThis skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.