claude-plugins

Create and validate Claude Code plugin.json manifests for schema compliance.

24|6|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/vinnie357/claude-skills --skill claude-plugins-vinnie357
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-plugins
Source: https://github.com/vinnie357/claude-skills/tree/main/claude-code/skills/claude-plugins
Command: npx skills add https://github.com/vinnie357/claude-skills --skill claude-plugins-vinnie357

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and tools for creating, validating, and managing plugin.json files for Claude Code plugins. It ensures plugins are correctly structured and compliant with the schema, preventing configuration errors and streamlining plugin development.

Core Features & Use Cases

  • Plugin Manifest Authoring: Learn the complete plugin.json schema, including required and optional fields for metadata, author information, and component paths (skills, commands, agents, hooks).
  • Schema & Path Validation: Utilize provided Nushell scripts to validate JSON syntax, field formats (kebab-case, semver), and ensure all referenced paths exist and are correctly structured.
  • Plugin Initialization & Formatting: Generate template plugin.json files and automatically format/sort existing ones for consistency and readability.
  • Use Case: When developing a new Claude Code plugin, use this skill to initialize the plugin.json file, add paths to your skills and commands, and then validate the entire manifest to catch errors before deployment.

Quick Start

Initialize a new 'plugin.json' file in your current directory using the provided Nushell script.

Frequently Asked Questions about claude-plugins

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

FAQPage Schema
How do I validate a Claude Code plugin.json manifest file?

Validate plugin.json files using provided Nushell scripts that check JSON syntax, enforce kebab-case naming, verify semantic versioning, confirm SPDX licenses, and validate that all referenced skill, command, agent, hook, and MCP configuration paths exist and are correctly structured.

What fields are required in a plugin.json file for Claude Code plugins?

Required fields include plugin name in kebab-case, semantic version, SPDX license identifier, author information, and component paths (skills, commands, agents, hooks, MCP configurations). The schema enforces metadata completeness and path correctness to prevent deployment errors.

How do I create and initialize a new plugin.json file?

Use the provided Nushell script to generate a template plugin.json file in your .claude-plugin directory. Add paths to your skills, commands, and other components, then validate the manifest using the schema validation tool before deployment.

Can I use this to check if my plugin configuration has errors?

Yes. The skill validates plugin.json for schema compliance, correct field formats, URL validity, and relative path checks across all component types. It catches configuration errors during development, preventing failures during plugin deployment.

Do I need to manually format my plugin.json file?

No. The skill provides automatic formatting and sorting tools that organize your plugin.json for consistency and readability, eliminating manual formatting work while maintaining schema compliance.