Consult
Drawn from 25 years of software engineering across startups and large
organizations, Consult is a human in the loop focused portable skill library for
raising the engineering maturity of coding agents.
Humans are good at mapping real-world issues to technical solutions, and, given enough context,
coding agents are good at generating a correct implementation. Consult does not try to
change either side of that equation: it does not automate humans away, and it
does not change how coding agents, or their harnesses, work internally. Instead, it
augments the collaboration between them so agent-assisted work produces simpler,
trustworthy, and maintainable production-grade software while humans still own
intent, design, and acceptance.
Consult is not a vibe-coding safety net. It works best when you have
enough software fundamentals to judge plans, tradeoffs, risk, and proof. Consult can
still suggest a solution, but it's more effective if you can make the hard
engineering decisions yourself (plus you'll actually know how the code works).
What Consult guides agents to do
- Keep humans in the loop for significant and hard-to-change work: public
interfaces, project structure, dependency picks, data boundaries, long-lived
behavior, substantial new modules, non-trivial logic, and deliberate behavior
changes.
- Use AI to improve the developer's mental model, not to replace it.
- Model data first: make values, states, and rules clear; limit side effects;
keep state changes at the edges.
- Show their work: prove behavior with tests, contracts, logs, or visible
checks rather than relying on what seems correct.
- Treat security, data safety, and accessibility as essential, not extras.
- Plan beyond launch: invest in observability, reliability, safe deployment,
and a rollback plan.
- Organize work into clear, reviewable changes humans can trust and maintain.
Install
Most users should install the package for their primary agent. Use the manual
install only when you want one shared skill directory across several tools, or
when your tool does not support plugins.
Claude Code
Inside Claude Code:
/plugin marketplace add kreek/consult
/plugin install consult@consult
Codex
codex plugin marketplace add kreek/consult
Then open /plugins in Codex, find Consult in the list,
press Enter to open its details, and select Install plugin.
To update:
codex plugin marketplace upgrade consult
Then open /plugins, find Consult in the list, press Enter
to open its details, and select Install plugin again.
Cursor
Install from the Cursor Marketplace (search for
Consult or submit this repo at
cursor.com/marketplace/publish if it is
not listed yet). Open the marketplace panel in Cursor, install consult, then
confirm skills under Settings → Rules → Agent Decides. Invoke a skill with
/skill-name in Agent chat (for example /workflow, /proof).
To test from a local checkout before marketplace listing:
mkdir -p ~/.cursor/plugins/local
cp -R /path/to/consult/plugin ~/.cursor/plugins/local/consult
Reload the window (Developer: Reload Window). Prefer cp -R over symlinks;
some Cursor builds do not load symlinked local plugins reliably.
If you also run ./setup.sh, Cursor can load the same skills twice (plugin plus
~/.agents/skills/). Use either the Cursor plugin or manual install for Cursor,
not both.
Developing inside this repository with a local plugin copy also duplicates skills
(project agents/.agents/skills/ plus the plugin). See
CONTRIBUTING.md.
Pi
pi install git:github.com/kreek/consult
github: is not a Pi package source prefix; use git: for GitHub shorthand.
After installing, run /reload inside Pi. Consult includes bundled skills plus
runtime extensions for /proof and /consult:self-review.
Google Antigravity
Antigravity's CLI (agy) manages plugins with agy plugin install. Consult ships a
ready-to-install plugin at plugin/ (a plugin.json marker plus a skills/
directory). Install it from a local checkout:
agy plugin install /path/to/consult/plugin
agy copies the plugin into ~/.gemini/antigravity-cli/plugins/consult and
registers its skills; verify with agy plugin list. Because it copies rather
than links, re-run the command (or ./setup.sh) after pulling new skills.
./setup.sh runs this automatically when agy is on your PATH.
Manual (multi-agent or unsupported plugins)
Prerequisites: Git and GNU Stow. Install Stow with one of:
brew install stow # macOS
apt install stow # Debian/Ubuntu
dnf install stow # Fedora/RHEL
git clone https://github.com/kreek/consult.git
cd consult
./setup.sh
