Validate Plugin Jeremylongshore

---
name: validate-plugin
description: "'Validate a Claude Code plugin directory against the official Anthropic spec and Intent Solutions enterprise standard. Runs structural validation (plugin.json fields, file references, permissions) and content validation (SKILL.md grading, command/agent frontmatter). Use when building a new plugin, preparing for marketplace submission, or auditing existing plugins. Trigger with \"validate this plugin\", \"check plugin structure\", \"grade my plugin\", \"/validate-plugin\". '"
allowed-tools: "Read, Bash(python3:*), Bash(jq:*), Bash(chmod:*), Glob, Grep"
category: ai-agents-and-harness
source_repo: jeremylongshore/claude-code-plugins-plus-skills
source_path: "skills/.curated/validate-plugin/SKILL.md"
source_url: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/skills/.curated/validate-plugin/SKILL.md
---

# Validate Plugin

Full plugin directory validator combining structural checks and content grading.

## Overview

Runs the complete validation pipeline against any plugin directory:

1. `validate-all-plugins.sh` for structural validation (plugin.json, file refs, permissions)
2. `validate-skills-schema.py` for content validation with 100-point grading

## Prerequisites

- Python 3 with `pyyaml` installed
- `jq` available on PATH
- Run from the claude-code-plugins repository root

## Instructions

1. Identify the target plugin directory (must contain `.claude-plugin/plugin.json`)
2. Run structural validation:

   ```bash
   ./scripts/validate-all-plugins.sh <plugin-directory>
   ```

3. Run content validation on any SKILL.md files found:

   ```bash
   python3 scripts/validate-skills-schema.py --verbose <path-to-SKILL.md>
   ```

4. If the plugin has commands or agents, validate those too:

   ```bash
   python3 scripts/validate-skills-schema.py --verbose
   ```

5. Report the combined results with per-skill 100-point grades

## Output

Present results in this format:

**Structural Validation:**

- plugin.json: PASS/FAIL (list any invalid fields)
- File references: PASS/FAIL
- Script permissions: PASS/FAIL

**Content Validation (per SKILL.md):**

- Grade: A-F (score/100)
- Errors: list
- Warnings: list

**Summary:**

- Total errors / warnings
- Overall verdict: PASS or FAIL

## Error Handling

- If plugin directory doesn't exist, report and exit
- If plugin.json is missing, report as structural failure
- If Python or jq not available, report as environment issue
- Continue validating remaining files even if one fails

## Examples

**Example 1: Validate a specific plugin**

```
/validate-plugin plugins/skill-enhancers/skill-creator/
```

**Example 2: Validate current directory**

```
validate this plugin
```

## Resources

- [Anthropic Plugins Reference](https://code.claude.com/docs/en/plugins-reference)
- [Anthropic Skills Spec](https://code.claude.com/docs/en/slash-commands)

---

**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `skills/.curated/validate-plugin/SKILL.md`

**Also appears in:** `jeremylongshore/claude-code-plugins-plus-skills/plugins/skill-enhancers/validate-plugin/skills/validate-plugin/SKILL.md`