plugin-structure

Guide Claude Code plugin architecture, manifest configuration, and component organization.

Updated Jan 11, 2017
One-click install
npx skills add https://github.com/kaustubhhiware/dotfiles --skill plugin-structure-kaustubhhiware
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/kaustubhhiware/dotfiles/tree/main/claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/kaustubhhiware/dotfiles --skill plugin-structure-kaustubhhiware

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance on building and organizing Claude Code plugins, ensuring adherence to best practices and efficient component management.

Core Features & Use Cases

  • Plugin Architecture: Understand directory layout, manifest configuration (plugin.json), and component organization (commands, agents, skills, hooks).
  • Best Practices: Learn about portable path references (${CLAUDE_PLUGIN_ROOT}), file naming conventions, and auto-discovery mechanisms.
  • Use Case: When starting a new Claude Code plugin project, use this Skill to scaffold the project structure, configure the manifest, and understand how to organize commands, agents, and skills for optimal maintainability and discoverability.

Quick Start

Use the plugin-structure skill to understand how to organize plugin components.

Frequently Asked Questions about plugin-structure

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

FAQPage Schema
How do I structure a Claude Code plugin project?

Scaffolding a Claude Code plugin requires a specific directory layout that organizes commands, agents, skills, and hooks. Configuring the `plugin.json` manifest properly ensures optimal maintainability and allows the system to automatically discover your plugin components.

What is the plugin.json manifest used for in Claude Code?

The `plugin.json` manifest configures your Claude Code plugin's core metadata and component organization. Defining this manifest correctly registers commands, agents, skills, and hooks so they become discoverable by the system.

How do I use portable path references in Claude Code plugins?

Portable path references in Claude Code plugins use the `${CLAUDE_PLUGIN_ROOT}` variable. This best practice ensures your plugin locates files dynamically without hardcoding absolute paths, maintaining portability across different environments.

How does auto-discovery work for Claude Code plugin components?

Auto-discovery for Claude Code plugin components recognizes standard file naming conventions and directory structures. Adhering to these organizational best practices allows the system to automatically detect and load your commands, agents, and skills.

What are the requirements for creating a Claude Code plugin?

Creating a Claude Code plugin requires a configured `plugin.json` manifest and an organized directory structure for components like commands, agents, and hooks. Following these architecture guidelines ensures your plugin is properly scaffolded and maintainable.