validate-plugin

Validate marketplace plugin structure, manifests, and frontmatter with PASS/FAIL results.

22|2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/tmchow/tmc-marketplace --skill validate-plugin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-plugin
Source: https://github.com/tmchow/tmc-marketplace/tree/main/.claude/skills/validate-plugin
Command: npx skills add https://github.com/tmchow/tmc-marketplace --skill validate-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate plugin structures and manifests against marketplace requirements to prevent publishing defects and ensure consistent quality.

Core Features & Use Cases

  • Validates plugin structure (plugins/<plugin-name>/.claude-plugin/plugin.json, README.md, skills/ or agents/ exist)
  • Validates plugin.json fields (name, version, description, author.name, skills/agents paths)
  • Validates Skill and Agent SKILL.md / AGENT.md frontmatter
  • Checks marketplace registry mapping in marketplace.json
  • Reports failures with actionable guidance for remediation

Quick Start

Run /validate-plugin <plugin-name> to validate a specific plugin.

Frequently Asked Questions about validate-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a plugin for marketplace readiness before publishing?

Validating a plugin for marketplace readiness involves checking the plugin directory structure, plugin.json schema, SKILL.md frontmatter, and marketplace.json entries. The process returns a PASS or FAIL result with detailed errors for any compliance issues found.

What does marketplace plugin validation check for in the plugin.json schema?

Marketplace plugin validation checks the plugin.json schema for required fields including name, version, description, author.name, and valid skills or agents paths. It ensures all mandatory metadata is present and correctly formatted for marketplace compliance.

How do I check SKILL.md frontmatter and code syntax in my marketplace plugin?

Automated plugin validation checks SKILL.md frontmatter presence for each skill and agent, runs code syntax checks, and applies optional deprecation rules. This ensures all skills and agents meet marketplace formatting and quality standards.

Why does my plugin validation fail when checking the marketplace registry mapping?

Plugin validation fails on the marketplace registry mapping when the plugin is missing or incorrectly listed in marketplace.json. The validator returns a FAIL result with detailed errors explaining exactly how to fix the registry mapping.

Can I validate the structure of a specific plugin without checking all marketplace plugins?

You can validate a specific plugin by running the validation command with the plugin name. This checks only that plugin's directory structure, plugin.json manifest, and SKILL.md or AGENT.md frontmatter, returning targeted PASS or FAIL results without scanning all marketplace plugins.

What are the limitations of automated plugin validation for marketplace compliance?

Automated plugin validation for marketplace compliance is limited to structural, schema, and frontmatter checks. It validates file presence, plugin.json fields, and code syntax but does not test runtime plugin behavior, functional performance, or subjective content quality.