cluesmith/codev/consult

Claude Code and agent skill by cluesmith/codev

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

AI consultation CLI — query Gemini, Codex, or Claude for reviews and analysis. ALWAYS check this skill before running any `consult` command. Use when reviewing specs, plans, implementations, or PRs with external models, running parallel 3-way reviews (cmap), or checking consultation stats. The `-m` model flag is always required except for `consult stats`.

Install

npx vskill@latest install cluesmith/codev/consult

SKILL.md

consult - AI Consultation CLI

Query external AI models for reviews and analysis. Supports Gemini, Codex, and Claude.

Synopsis

consult -m <model> [options]
consult stats [options]

The -m / --model flag is always required except for consult stats.

Models

Flag valueAliasNotes
geminiproAntigravity CLI (agy); agentic file access (--sandbox), OAuth login; skips non-blockingly if unavailable
codexgptThorough (~200-250s), shell exploration
claudeopusAgent SDK with tool use (~60-120s)

Credentials and .env

consult loads <workspace>/.env and sets every key the shell does not already define, credentials included. Those override your stored login:

  • claude: CLAUDE_CODE_OAUTH_TOKEN (or ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY) beats the keychain login. When an OAuth token is set, the API keys are dropped.
  • codex: CODEX_API_KEY beats the ChatGPT login. OPENAI_API_KEY is ignored.

Each SDK lane prints what it authenticates with, e.g. [CLAUDE] auth: CLAUDE_CODE_OAUTH_TOKEN (from .env). If a review fails with a usage-limit or auth error while your own login works, check that line first. A key exported in the shell wins over .env.

All flags

-m, --model <model>         Model to use (required except stats)
--prompt <text>              Inline prompt (general mode)
--prompt-file <path>         Prompt file path (general mode)
--protocol <name>            Protocol: spir, aspir, air, bugfix, maintain
-t, --type <type>            Review type (see below)
--issue <number>             Issue number (required in architect context)
--output <path>              Save result to file
--plan-phase <phase>         Scope review to a plan phase (porch use)
--context <path>             Context file with feedback (porch use)
--project-id <id>            Project ID for metrics (porch use)
--days <n>                   Stats: limit to last N days (default: 30)
--project <id>               Stats: filter by project ID
--last <n>                   Stats: show last N invocations
--json                       Stats: output as JSON

Review types (--type)

TypeWhen to use
specReview a specification for completeness
planReview an implementation plan
implReview code implementation
prReview a pull request before merge
phasePhase-scoped review (builder context only)
integrationArchitect's integration review of a PR

Usage patterns

General query:

bash
consult -m gemini --prompt "What's the best way to structure auth?"
consult -m codex --prompt-file review-checklist.md

Protocol review:

bash
consult -m gemini --type spec --issue 42
consult -m codex --type plan --issue 42
consult -m claude --type integration --issue 42

3-way parallel review (cmap): Always use --output for background runs — without it, results go to a temp file that may be garbage-collected.

bash
consult -m gemini --type integration --issue 42 --output /tmp/cmap-gemini-42.md &
consult -m codex --type integration --issue 42 --output /tmp/cmap-codex-42.md &
consult -m claude --type integration --issue 42 --output /tmp/cmap-claude-42.md &
wait

Stats:

bash
consult stats                     # 30-day summary
consult stats --days 7 --json     # Last 7 days as JSON
consult stats --project 42        # Filter by project

Rules

  • -m is required for all non-stats commands
  • --prompt and --type are mutually exclusive (different modes)
  • --prompt and --prompt-file are mutually exclusive
  • --protocol requires --type
  • From architect context (outside .builders/), --issue is required for protocol reviews
  • From builder context (inside .builders/), project auto-detects from porch state

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/cluesmith/codev/consult/badge)](https://verified-skill.com/skills/cluesmith/codev/consult)

Something wrong with this skill or its page? Tell us.