Capability Discovery
The pipeline should never invent tools. Before drafting a kit that references
GitHub Actions, Supabase, Codex, or any other external dependency, check what
actually exists.
What we detect
- CLI tools on $PATH:
gh, git, node, go, rustc, cargo,
python3, pip, docker, vercel, supabase, firebase, wrangler,
ffmpeg, playwright, codex, graphify.
- MCP servers: parsed from
.mcp.json in the project root and
~/.claude.json (user level).
- Claude Code plugins: parsed from
~/.claude/plugins/installed_plugins.json.
- Codex: presence of the
codex CLI (enables peer-review commands).
- Knowledge graph: presence of
graphify-out/graph.json (enables the
graphify-integration skill).
Running discovery
node "${CLAUDE_PLUGIN_ROOT}/scripts/cavekit-tools.cjs" discover
Writes .cavekit/capabilities.json:
{
"discovered_at": "2026-04-17T14:22Z",
"cli_tools": {
"gh": true, "git": true, "node": true, "codex": false
},
"mcp_servers": ["codex-reviewer", "graphify"],
"plugins": [],
"codex": { "available": false }
}
How other commands use it
/ck:sketch — reads capabilities before proposing integrations. If a
kit would need a missing tool, it either adds a "Setup" task to the build
site or asks the user whether to proceed without it.
/ck:map — flags tasks that depend on missing capabilities as
blocked: setup-required.
/ck:make — refuses to dispatch subagents that require a missing MCP
server.
/ck:check — includes a "Capability Coverage" section in the inspect
report.
When to re-run
- After installing a new CLI tool.
- After adding or removing an MCP server.
- At the start of every new project (via
/ck:init).
- Whenever a task fails with "command not found".
The file is cheap to regenerate — always discover, never guess.
What we deliberately do not detect
- Network-accessible APIs behind credentials. Availability is not reachability;
kits should record credentials as a separate concern (never committed).
- IDE extensions. They are not scriptable from the loop and would create false
assurances.
- Language versions. Version-pinning is the project's responsibility
(package.json / go.mod / pyproject.toml); discovery only confirms
executables exist.
1---2name: capability-discovery3description: |4 Detect which MCP servers, Claude Code plugins, and CLI tools are available5 in the current environment, so kits and build sites can bind to real6 capabilities instead of imagined ones. Runs via /ck:init --tools-only or7 `cavekit-tools.cjs discover`. Writes .cavekit/capabilities.json. Trigger8 phrases: "what do we have available", "what's installed", "detect tools",9 "can we use X", "setup tools".10metadata:11 source: https://skillmd.com/skills/hashgraph-online/capability-discovery12---1314# Capability Discovery1516The pipeline should never invent tools. Before drafting a kit that references17GitHub Actions, Supabase, Codex, or any other external dependency, check what18actually exists.1920## What we detect2122- **CLI tools on $PATH**: `gh`, `git`, `node`, `go`, `rustc`, `cargo`,23 `python3`, `pip`, `docker`, `vercel`, `supabase`, `firebase`, `wrangler`,24 `ffmpeg`, `playwright`, `codex`, `graphify`.25- **MCP servers**: parsed from `.mcp.json` in the project root and26 `~/.claude.json` (user level).27- **Claude Code plugins**: parsed from `~/.claude/plugins/installed_plugins.json`.28- **Codex**: presence of the `codex` CLI (enables peer-review commands).29- **Knowledge graph**: presence of `graphify-out/graph.json` (enables the30 `graphify-integration` skill).3132## Running discovery3334```bash35node "${CLAUDE_PLUGIN_ROOT}/scripts/cavekit-tools.cjs" discover36```3738Writes `.cavekit/capabilities.json`:3940```json41{42 "discovered_at": "2026-04-17T14:22Z",43 "cli_tools": {44 "gh": true, "git": true, "node": true, "codex": false45 },46 "mcp_servers": ["codex-reviewer", "graphify"],47 "plugins": [],48 "codex": { "available": false }49}50```5152## How other commands use it5354- **`/ck:sketch`** — reads capabilities before proposing integrations. If a55 kit would need a missing tool, it either adds a "Setup" task to the build56 site or asks the user whether to proceed without it.57- **`/ck:map`** — flags tasks that depend on missing capabilities as58 `blocked: setup-required`.59- **`/ck:make`** — refuses to dispatch subagents that require a missing MCP60 server.61- **`/ck:check`** — includes a "Capability Coverage" section in the inspect62 report.6364## When to re-run6566- After installing a new CLI tool.67- After adding or removing an MCP server.68- At the start of every new project (via `/ck:init`).69- Whenever a task fails with "command not found".7071The file is cheap to regenerate — always discover, never guess.7273## What we deliberately do not detect7475- Network-accessible APIs behind credentials. Availability is not reachability;76 kits should record credentials as a separate concern (never committed).77- IDE extensions. They are not scriptable from the loop and would create false78 assurances.79- Language versions. Version-pinning is the project's responsibility80 (package.json / go.mod / pyproject.toml); discovery only confirms81 executables exist.