plugin-structure

Guide Claude Code plugin architecture, directory layout, and manifest configuration.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Himanshu040604/codex-skills-setup --skill plugin-structure-himanshu040604
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/Himanshu040604/codex-skills-setup/tree/main/assets/codex/skills/claude-import/skills/plugins/plugin-dev%40claude-plugins-official/skills/plugin-structure
Command: npx skills add https://github.com/Himanshu040604/codex-skills-setup --skill plugin-structure-himanshu040604

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill demystifies the creation and organization of Claude Code plugins, providing a clear roadmap for developers to build robust and maintainable extensions.

Core Features & Use Cases

  • Understand Plugin Architecture: Learn the standard directory layout, manifest configuration, and component organization.
  • Automate Plugin Development: Get guidance on setting up plugin.json, using portable path references, and adhering to naming conventions.
  • Use Case: A new developer needs to create their first Claude Code plugin. They use this Skill to understand the required file structure, how to define commands and agents, and how to configure the plugin.json manifest for proper discovery and functionality.

Quick Start

Use the plugin-structure skill to understand how to organize files for a new Claude Code plugin.

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 manifest and directory layout?

A Claude Code plugin requires a standard directory layout and a configured plugin.json manifest to define commands, agents, skills, and hooks for proper auto-discovery and functionality.

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

The plugin.json manifest configures core plugin settings in Claude Code, enabling proper component organization and auto-discovery mechanisms for commands, agents, skills, and hooks.

How do I use portable path references in Claude Code plugin development?

Use the `${CLAUDE_PLUGIN_ROOT}` variable to create portable path references in your plugin, ensuring directory references remain valid regardless of the installation environment.

What are the file naming conventions for Claude Code plugin components?

Claude Code plugin components require adhering to specific file naming conventions to ensure proper auto-discovery mechanisms can correctly locate commands, agents, skills, and hooks.

Do I need any dependencies to create a Claude Code plugin?

No external dependencies are required to structure a Claude Code plugin, as the architecture relies on standard directory layouts, manifest configuration, and portable path references.

What's the best way to organize commands and agents in a Claude Code plugin?

Organize commands and agents using the standard component organization structure within your plugin directory, ensuring each component is properly configured in the plugin.json manifest for discovery.