How can I debug a plugin that isn't loading?

Run Claude in debug mode using 'claude --debug' or use the '/plugin' command and navigate to the Errors tab to see specific manifest or loading failures.

What is the required structure for a Claude Code plugin?

A plugin requires a .claude-plugin/ directory containing a plugin.json manifest, with optional directories for commands, agents, skills, and hooks at the root.

What is the function of the CLAUDE_PLUGIN_ROOT variable?

It is an environment variable used within hooks and MCP configurations to dynamically reference the absolute path of the plugin's root directory.

How do I install a plugin to a specific project scope?

You can use the command 'claude plugin install plugin-name@marketplace --scope project' to save it to the project's .claude/settings.json file.

Claude Code Plugin Development Reference

Name: Claude Code Plugin Development Reference
Author: Dunc4nJ

byDunc4nJ

•

Learning & Documentation

Provides technical specifications and implementation patterns for building, bundling, and distributing Claude Code plugins.

This skill acts as a comprehensive technical guide for developers creating extensions for Claude Code. It covers everything from the required plugin.json manifest schema and standardized directory structures to advanced configurations for hooks, MCP servers, and LSP servers. By offering clear patterns for multi-scope installations and marketplace management, it ensures that developers can efficiently package and share custom commands, subagents, and skills across teams or the broader community.

Key Features

01Detailed plugin.json manifest schema and field definitions

02Standardized directory layout for commands, agents, skills, and hooks

03Installation patterns for user, project, and local scopes

04Marketplace setup and distribution management commands

05Configuration guides for MCP and LSP server integration

061 GitHub stars

Use Cases

01Setting up a private team marketplace for internal AI tools

02Structuring a new Claude Code plugin from scratch with best practices

03Troubleshooting plugin loading errors or path resolution issues

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dunc4nj/entropy-plugins plugins-reference

For use in Claude.ai and ChatGPT

Download Skill