Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

plugin-validator

verified

Validates SpecWeave plugin installation when EXPLICITLY requested by user. Use for checking if plugins are installed correctly, validating marketplace registration, or troubleshooting missing plugins. Only triggers on explicit requests to avoid false positives during normal workflow.

View on GitHub

Marketplace

specweave

anton-abyzov/specweave

Plugin

sw

development

Repository

anton-abyzov/specweave
31stars

plugins/specweave/skills/plugin-validator/SKILL.md

Last Verified

February 3, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/anton-abyzov/specweave/blob/main/plugins/specweave/skills/plugin-validator/SKILL.md -a claude-code --skill plugin-validator

Installation paths:

Claude
.claude/skills/plugin-validator/
Powered by add-skill CLI

Instructions

# 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-

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
11951 chars