Validates SpecWeave plugin installation when EXPLICITLY requested by user. Ensures marketplace registered, core plugin installed, and context-specific plugins available. ONLY activates for explicit validation requests - does NOT auto-activate for workflow commands to avoid false positives. Activates ONLY for plugin validation, environment setup, validate plugins, check plugins, specweave init, fresh setup, marketplace registration.
View on GitHubanton-abyzov/specweave
sw
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/anton-abyzov/specweave/blob/main/plugins/specweave/skills/plugin-validator/SKILL.md -a claude-code --skill plugin-validatorInstallation paths:
.claude/skills/plugin-validator/# Plugin Validator Skill
**Purpose**: Validate and install SpecWeave plugins when explicitly requested by the user.
**Activation**: Triggers ONLY when user explicitly requests plugin validation (e.g., "validate plugins", "check plugins", or runs `specweave validate-plugins` command). Does NOT auto-activate for workflow commands to prevent false positive errors.
## What This Skill Does
This skill ensures that your SpecWeave environment is properly configured with all required plugins BEFORE you start working. It prevents frustrating errors and wasted time from missing components.
### Key Features
1. **Marketplace Validation**: Ensures SpecWeave marketplace is registered in `~/.claude/settings.json`
2. **Core Plugin Check**: Verifies `specweave` plugin is installed
3. **Context Detection**: Analyzes your increment description and suggests relevant plugins
4. **Auto-Installation**: Can automatically install missing components (with your permission)
5. **Clear Guidance**: Shows exactly what's missing and how to fix it
## When This Skill Activates
✅ **ONLY activates when explicitly requested**:
- You mention "plugin validation" or "validate plugins"
- You mention "environment setup" or "check plugins"
- You run: `specweave validate-plugins`
- You ask: "Can you validate my plugins?"
- You report: "I'm getting plugin errors"
- During: `specweave init` (initial setup only)
❌ **Does NOT auto-activate for**:
- `/sw:increment` commands
- `/sw:do` commands
- Any other workflow commands
- Reason: Prevents false positive errors when plugins are installed but detection fails
## Validation Process
### Phase 1: Marketplace Check
**What**: Checks if SpecWeave marketplace is registered in Claude Code
**Where**: `~/.claude/settings.json`
**Expected**:
```json
{
"extraKnownMarketplaces": {
"specweave": {
"source": {
"source": "github",
"repo": "anton-abyzov/specweave",
"path": ".claude-plugin"
}
}
}
}
```
**If missing**: Auto-