anthropics avatar

Plugin Structure

This teaches you the anatomy of a Claude Code plugin: where to put your plugin.json manifest, how to organize commands, agents, skills, and hooks into the right directories, and why you should always use ${CLAUDE_PLUGIN_ROOT} instead of hardcoded paths. The structure is mostly convention-based, so dropping a .md file in the commands folder makes it available as a slash command without extra wiring. Use this when scaffolding a new plugin or when your components aren't loading and you need to check if they're in the wrong place. The emphasis on portable paths is smart, since plugins get installed in different locations depending on how users set them up.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
6
skills.sh installs
7.3K
GitHub stars
46.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add anthropics/claude-plugins-official --skill plugin-structure --agent claude-code

Installs into .claude/skills of the current project.

Files

Plugin Structure for Claude Code

Overview

Claude Code plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Claude Code.

Key concepts:

  • Conventional directory layout for automatic discovery
  • Manifest-driven configuration in .claude-plugin/plugin.json
  • Component-based organization (commands, agents, skills, hooks)
  • Portable path references using ${CLAUDE_PLUGIN_ROOT}
  • Explicit vs. auto-discovered component loading

Directory Structure

Every Claude Code plugin follows this organizational pattern:

Sponsors

Details

Repository
github.com/anthropics/claude-plugins-official
Categories
Frontend Development, Code Review & Quality, Automation & Workflows, Sales & Marketing
First seen
May 16, 2026

More from anthropics/claude-plugins-official

All 24
1github avatarmsstore-cligithub/awesome-copilotMicrosoft Store Developer CLI (msstore) for publishing Windows applications to the Microsoft Store. Use when asked to configure Store credentials, list Store ap7Kskills.sh installs
2aws avataraws-amplifyaws/agent-toolkit-for-awsBuild and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first). Covers auth (Cognito), data (AppSync/DynamoDB), storage (S3), fun7Kskills.sh installs
3github avatarcreate-web-formgithub/awesome-copilotCreate robust, accessible web forms with best practices for HTML structure, CSS styling, JavaScript interactivity, form validation, and server-side processing. 7Kskills.sh installs
4jimliu avatarbaoyu-designjimliu/baoyu-designCreate polished design artifacts as self-contained HTML: UI mockups, interactive prototypes, wireframes, landing pages, dashboards, app screens, mobile apps, sl7Kskills.sh installs
5pixijs avatarpixijs-scene-textpixijs/pixijs-skillsUse this skill when rendering text in PixiJS v8. Covers Text for canvas-quality styled labels, BitmapText for cheap per-frame updates via glyph atlas, HTMLText 6.9Kskills.sh installs
6pixijs avatarpixijs-colorpixijs/pixijs-skillsUse this skill when creating, converting, or manipulating colors in PixiJS v8. Covers Color class input formats (hex, CSS names, RGB/HSL objects, arrays, Uint8A6.8Kskills.sh installs