| name | weave-install |
| description | This skill should be used when the user wants to "install the weave plugin", "set up weave", "install weave-claude-plugin", "configure weave for the first time", "get started with weave tracing", or needs to complete the initial setup of the Weave Claude Code plugin including dependency installation and project configuration. |
Weave Claude Code Plugin — Install
Complete the full installation and initial configuration of the Weave Claude Code plugin.
Step 1 — Check for CLI
Run:
which weave-claude-plugin
If not found, install it:
npm install -g weave-claude-plugin
Then verify it is now available:
which weave-claude-plugin
If the install fails (e.g., permission error), retry with sudo npm install -g weave-claude-plugin after confirming with the user. Do not proceed to Step 2 until which weave-claude-plugin succeeds.
Step 2 — Run Install
Run:
weave-claude-plugin install
This creates ~/.weave_claude_plugin/settings.json, registers the plugin in Claude Code's marketplace, and installs hooks. If the command reports the installation already exists, continue to Step 3 to verify configuration.
If --force is needed to reinstall, run:
weave-claude-plugin install --force
Step 3 — Configure Weave Project
Check if weave_project is already set:
weave-claude-plugin config get weave_project
If not set (output is (not set)), ask the user for their Weave entity and project name in the format entity/project, then set it:
weave-claude-plugin config set weave_project ENTITY/PROJECT
Step 4 — Configure API Key
Check if wandb_api_key is configured or the WANDB_API_KEY environment variable is set. Run:
weave-claude-plugin config show
If wandb_api_key shows (not set) and no env var is active, ask the user for their W&B API key (available at https://wandb.ai/authorize) and set it:
weave-claude-plugin config set wandb_api_key API_KEY
Step 5 — Verify
Run a final status check:
weave-claude-plugin status
Confirm all items show ✓. If anything shows ✗, diagnose and fix before finishing.
Report the result to the user. On success, tell them that Claude Code sessions will now be automatically traced to their Weave project starting from the next session.
