consulting-design — Claude Code skill: what it does, how to install
consulting-design brings Gemini into your workflow to evaluate design trade-offs, review architecture, and brainstorm alternatives via MCP tools.
MIT 140 installs ★ 17 updated 2026-10-14
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a claude-codeWhat consulting-design does
The skill routes design discussions to Gemini via two MCP tools: mcp__gemini__ask-gemini using gemini-2.5-pro for architectural trade-offs, and mcp__gemini__brainstorm for exploring alternative solutions. Brainstorming supports several structured methodologies: divergent, convergent, scamper, design-thinking, lateral, and auto.
The ask-gemini tool does not carry conversation history between calls. If you need a multi-turn critique, you must pass prior messages concatenated in the prompt text. In addition, brainstorm caps responses at 5 ideas unless you explicitly override the count.
Outputs are non-deterministic, so useful ideas should be saved right away. If you exhaust a free-tier API quota, the project stays locked out until midnight Pacific time.
What it helps with
- evaluate architectural trade-offs with Gemini
- brainstorm alternative approaches using SCAMPER or lateral thinking
- gather structured design ideas beyond the default 5-item cap
- get an external model review on system structure
Example prompts for the agent
- Ask Gemini to review trade-offs for moving from polling to websockets
- Brainstorm 10 creative ways to handle offline sync using the divergent methodology
How to install consulting-design
1Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a claude-code2Manually: put the files in place
~/.claude/skills/consulting-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/consulting-design/
1Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a codex2Manually: put the files in place
.agents/skills/consulting-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a cursor2Manually: put the files in place
.cursor/skills/consulting-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install julianobarbosa/claude-code-skills skills/consulting-design2Manually: put the files in place
.github/skills/consulting-design/SKILL.md1Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/julianobarbosa/claude-code-skills --path skills/consulting-designManually: put the files in place
.devin/skills/consulting-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add julianobarbosa/claude-code-skills --skill consulting-design -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 consulting-design
How to install consulting-design in Claude Code?
Run npx skills add julianobarbosa/claude-code-skills --skill consulting-design -a claude-code. The skill file lands in ~/.claude/skills/consulting-design/SKILL.md.
What does consulting-design do?
It consults Gemini models for design alternatives, architecture trade-offs, and structured brainstorming sessions.
Does ask-gemini preserve context across prompts?
No, each call is stateless. You must include past conversation turns directly in each new prompt to maintain continuity.
Source text
SKILL.md · MIT
---
name: consulting-design
description: Consult Gemini AI for architecture alternatives, design trade-offs, and brainstorming. Use when seeking different perspectives on design, evaluating architectural approaches, comparing solutions, or generating creative ideas.
allowed-tools: Read, Grep, Glob, mcp__gemini__ask-gemini, mcp__gemini__brainstorm
---
# Design Consultation with Gemini
## Tools
| Tool | Use For |
| ------------------------- | ------------------------------------------- |
| `mcp__gemini__ask-gemini` | Architecture, design review, trade-offs |
| `mcp__gemini__brainstorm` | Generating alternatives, creative solutions |
## ask-gemini
```json
{
"prompt": "I'm designing [system]. Current approach: [desc]. Trade-offs and alternatives?",
"model": "gemini-2.5-pro"
}
```
Options: `changeMode: true` for structured edits, `sandbox: true` for code execution
## brainstorm
```json
{
"prompt": "How might we [challenge]?",
"domain": "software",
"methodology": "auto",
"ideaCount": 10
}
```
Methodologies: `divergent`, `convergent`, `scamper`, `design-thinking`, `lateral`, `auto`
---
## Gotchas
- **Gemini brainstorm output is non-deterministic** — same prompt rerun gives different ideas; save outputs you want to reference.
- **`ask-gemini` doesn't preserve conversation context across calls** — multi-turn questions need explicit history concatenation in each prompt.
- **API quota is per-project per-day** — bursting on a free tier locks the project out until midnight Pacific.
- **Output is markdown but can include LaTeX math** — downstream tooling that doesn't render math gets garbled output without warning.
- **`brainstorm` defaults to 5 ideas** — for divergent ideation, explicitly request more; the default is a hard cap.
© julianobarbosa · MIT · julianobarbosa/claude-code-skills