// 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.
This skill should be used when the user wants to "configure weave", "set weave project", "change weave project", "set wandb api key", "update weave settings", "show weave config", "change weave configuration", or needs to read or update any Weave Claude Code plugin settings.
This skill should be used when the user wants to "check weave status", "verify the weave plugin is running", "see if weave is set up correctly", "check weave configuration", "is weave working", or needs to diagnose why Claude Code sessions are not appearing in Weave.
| 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. |
Complete the full installation and initial configuration of the Weave Claude Code plugin.
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.
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
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
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
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.