How can I verify if my plugin paths are correct?

You can use the validate-plugin-paths.nu script provided by this skill to check if all skill directories, command files, and agents exist and are accessible.

Why shouldn't I include dependencies in my plugin.json?

The 'dependencies' field is reserved for marketplace.json entries; including it in a local plugin.json manifest is considered invalid and may cause validation errors.

Can I configure MCP servers directly in the plugin manifest?

Yes, MCP servers can be configured either as an inline object directly in plugin.json or as a path reference to a separate mcp-config.json file.

Where should the Claude Code plugin manifest be located?

All plugin manifests must be stored at the relative path .claude-plugin/plugin.json within your plugin's root directory.

What is the correct naming convention for a Claude plugin?

Plugins must use kebab-case naming (lowercase letters, numbers, and hyphens only). For example, 'my-custom-plugin' is valid, but 'MyPlugin' is not.

Claude Plugin Architect

Name: Claude Plugin Architect
Author: vinnie357

byvinnie357

0•

Deployment & DevOps

Streamlines the creation, validation, and management of plugin.json manifests for Claude Code extensions.

The Claude Plugin Architect skill is a specialized guide and toolset designed to simplify the development lifecycle of Claude Code plugins. It provides comprehensive schema validation, enforces naming conventions, and ensures that all internal paths for skills, commands, and agents are correctly mapped. By using this skill, developers can automate the validation of manifest files, avoid common configuration errors like using marketplace-only fields, and maintain semantic versioning standards, ultimately ensuring their plugins load reliably within the Claude environment.

Key Features

01Relative path verification for skills, commands, agents, and MCP servers

02Detection of invalid marketplace-level metadata in local manifests

030 GitHub stars

04Enforcement of kebab-case naming conventions and semantic versioning

05Support for inline or referenced hooks and MCP server configurations

06Automated plugin.json schema validation for syntax and field requirements

Use Cases

01Validating complex plugin configurations before submission to a repository

02Troubleshooting plugin loading issues by validating manifest compliance

03Scaffolding new plugin directory structures and manifest templates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vinnie357/claude-skills claude-plugins

For use in Claude.ai and ChatGPT

Download Skill