skills.rest
angrybeagles
angrybeaglesCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

Design and validate Claude Code plugin directory layouts and manifest structures.

Updated Apr 13, 2026
Search Tags:#architecture#plugin#organization#manifest#best-practices#claude-code#auto-discovery
One-click install
npx skills add https://github.com/angrybeagles/weather-dashboard --skill plugin-structure-angrybeagles
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/angrybeagles/weather-dashboard/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/angrybeagles/weather-dashboard --skill plugin-structure-angrybeagles

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This content helps developers understand and implement Claude Code plugin structures, making it easier to scaffold, organize, and validate plugins.

Core Features & Use Cases

  • Directory structure guidance and best practices for plugin layouts
  • Manifest placement, auto-discovery configuration, and component organization patterns
  • Portable path references and naming conventions to ensure cross-environment compatibility

Quick Start

Begin by inspecting the SKILL.md to learn the recommended layout and then apply these guidelines to your plugin project.

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?▼

Structure your Claude Code plugin by placing a manifest.json at the root directory to enable auto-discovery. Follow naming conventions and organize components logically to ensure the environment detects your plugin automatically.

What is the best way to organize plugin components and manifests?▼

Organize plugin components by following standard directory layout patterns and using portable path references. This maintains cross-environment compatibility and prevents broken references when deploying the plugin across different systems.

How does manifest.json configuration affect plugin architecture?▼

Manifest.json configuration defines the plugin architecture by specifying component locations and auto-discovery settings. Proper manifest placement is critical for the environment to correctly map and load plugin features without manual intervention.

Can I audit an existing Claude Code plugin layout against best practices?▼

Yes, you can audit an existing Claude Code plugin layout by validating its directory structure, manifest placement, and naming conventions against established best practices. This helps identify configuration issues and improve cross-environment portability.

Why do my plugin path references break across different environments?▼

Plugin path references break across environments when they are not configured as portable path references. Use relative paths and adhere to strict naming conventions in your manifest.json to ensure cross-environment compatibility.

Related Skills

Explore More Software Engineering Skills→
MakisuoMakisuo
1.6k

clickhousectl-local-dev

Install and configure a local ClickHouse environment with clickhousectl.

Community
Intermediate
NGTPTENGTPTE

plugin-structure

Structure Claude Code plugin directories and manifests for reliable component discovery.

Community
Advanced
avifeneshavifenesh
951

enhance-plugins

Analyze plugin structures, MCP tools, and security patterns for compliance gaps.

Community
Advanced
aah-stackaah-stack

plugin-structure

Organize Claude Code plugin directory structures and manifest configurations.

Community
Advanced