Plugin Structure

Guide Claude Code plugin architecture with directory structure and manifest configuration.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/AWS-Educate/template-nextjs-sanity-tailwind-amplify --skill plugin-structure-aws-educate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Plugin Structure
Source: https://github.com/AWS-Educate/template-nextjs-sanity-tailwind-amplify/tree/main/.agents/skills/plugin-structure
Command: npx skills add https://github.com/AWS-Educate/template-nextjs-sanity-tailwind-amplify --skill plugin-structure-aws-educate

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive understanding of how to build, organize, and deploy Claude Code plugins, eliminating guesswork in plugin development.

Core Features & Use Cases

  • Plugin Architecture: Learn the standard directory layout and manifest configuration.
  • Component Organization: Understand how to structure commands, agents, skills, and hooks for maintainability.
  • Use Case: When you need to create a new plugin for Claude Code, this Skill will guide you through setting up the correct file structure, configuring the plugin.json manifest, and organizing your components for automatic discovery.

Quick Start

Use the plugin structure skill to create a new plugin with a single command.

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 for auto-discovery?

To structure a Claude Code plugin for auto-discovery, you must follow a standard directory layout that organizes commands, agents, skills, and hooks into specific component folders. This allows the system to automatically detect and load your components without manual registration.

What is the purpose of the plugin.json manifest in Claude Code?

The plugin.json manifest in Claude Code serves as the central configuration file that defines your plugin's architecture and component organization. It eliminates guesswork by specifying exactly how your commands, agents, and MCP servers are structured and deployed.

Can I use portable path references when developing Claude Code plugins?

Yes, you can use portable path references when developing Claude Code plugins. This practice ensures your plugin architecture remains maintainable and deployable across different environments without breaking component auto-discovery mechanisms or file links.

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

The best way to organize commands and hooks in a Claude Code plugin is to follow the standard component organization guidelines. Separating these components into dedicated directories ensures maintainability and allows the auto-discovery mechanisms to function correctly during deployment.

Does Claude Code plugin architecture require specific dependencies for scaffolding?

Claude Code plugin architecture does not require external dependencies for scaffolding. You can create a new plugin with a single command by leveraging the standard directory structure and manifest configuration provided by the architecture guidelines.