# claude-plugin-validation

claude-plugin-validation is a Claude Code skill that audits plugin structure, manifests, and frontmatter. It catches JSON syntax errors and encoding issues before release.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 28 repo stars
- Author: bejranonda
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude/tree/HEAD/skills/claude-plugin-validation/SKILL.md
- Updated: 2026-06-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/claude-plugin-validation

## What it does

This tool audits Claude Code extension packages to catch structural defects prior to distribution. It inspects `.claude-plugin/plugin.json` to confirm standard JSON syntax, semantic versioning formats, and required metadata such as author, name, version, and description.

Validation rules inspect folder hierarchies and Markdown headers across agents, skills, and command definitions. The skill checks YAML frontmatter for indentation tabs or duplicate keys, while enforcing UTF-8 encoding without byte order marks. Path length limits and LF line endings are also verified for cross-platform setups.

Manifest files over 1MB are flagged immediately. This prevents slow startup times during extension discovery.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/claude-plugin-validation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/claude-plugin-validation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/claude-plugin-validation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/claude-plugin-validation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude skills/claude-plugin-validation
```

2. **Manually: put the files in place**
- File: `.github/skills/claude-plugin-validation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --path skills/claude-plugin-validation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/claude-plugin-validation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude --skill claude-plugin-validation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bejranonda/LLM-Autonomous-Agent-Plugin-for-Claude/tree/HEAD/skills/claude-plugin-validation/SKILL.md

## When to use it
- validate `plugin.json` schema and required metadata fields
- detect formatting syntax errors in YAML frontmatter
- audit repository files for UTF-8 encoding and LF line endings
- identify cross-platform path length and casing issues

## Example prompts
- Validate the plugin manifest and folder structure before release
- Check agent and skill files for invalid YAML frontmatter
- Scan this plugin repository for encoding and line ending issues

## Similar
- [implementing-api-schema-validation-security](https://affpapa.org/en/nevibecode/skills/implementing-api-schema-validation-security.md) — skill · 280 installs
- [zod-validation](https://affpapa.org/en/nevibecode/skills/zod-validation.md) — skill · 222 installs
- [schema-e2e-validation](https://affpapa.org/en/nevibecode/skills/schema-e2e-validation.md) — skill · 123 installs
- [Stepgate](https://affpapa.org/en/nevibecode/mcp/stepgate.md) — MCP server · ★ 15 repo stars
- [gitlab-ci-validator](https://affpapa.org/en/nevibecode/skills/gitlab-ci-validator.md) — skill · 758 installs
- [validate-plugin](https://affpapa.org/en/nevibecode/skills/validate-plugin.md) — skill · 742 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
