skills.rest
ffalor
ffalorCOMMUNITY
Explore all skills by this author →
GitHub

plugin-structure

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

1|Updated Feb 2, 2026
Search Tags:#architecture#claude code#plugin development#manifest#component organization#auto-discovery
One-click install
npx skills add https://github.com/ffalor/agentic-coding --skill plugin-structure-ffalor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/ffalor/agentic-coding/tree/main/plugins/plugin-dev/skills/plugin-structure
Command: npx skills add https://github.com/ffalor/agentic-coding --skill plugin-structure-ffalor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides comprehensive guidance on building and organizing Claude Code plugins, ensuring they are discoverable, maintainable, and integrate seamlessly.

Core Features & Use Cases

  • Plugin Architecture: Understand directory layout, manifest configuration, and component organization.
  • Auto-Discovery: Learn how Claude Code automatically finds commands, agents, skills, and hooks.
  • Portable Paths: Master the use of ${CLAUDE_PLUGIN_ROOT} for robust plugin development.
  • Use Case: You need to create a new plugin for your team. This Skill will guide you through setting up the correct directory structure, configuring the plugin.json manifest, and organizing your commands, agents, and skills for optimal discoverability and maintainability.

Quick Start

Use the plugin-structure skill to understand the basic directory layout 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 for auto-discovery?▼

To configure the plugin manifest for Claude Code, you edit the plugin.json file to define your directory structure, component organization, and auto-discovery mechanisms. This setup ensures commands, agents, skills, and hooks are seamlessly discoverable and maintainable.

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

Auto-discovery works by leveraging a specific directory layout and manifest configuration in your Claude Code plugin. This mechanism automatically finds commands, agents, skills, and hooks without requiring explicit manual registration for each component.

What is the best way to use portable paths in Claude Code plugin development?▼

The best way to use portable paths in Claude Code plugin development is to utilize the `${CLAUDE_PLUGIN_ROOT}` variable. This ensures your path references remain robust and portable across different environments during component integration.

Do I need a manifest file to organize commands and hooks in Claude Code?▼

Yes, you need a plugin.json manifest file to properly organize commands and hooks in Claude Code. The manifest configuration defines the directory structure and enables the auto-discovery mechanisms required for seamless component integration.

What are the limitations when configuring a Claude Code plugin directory layout?▼

Limitations when configuring a Claude Code plugin directory layout include ensuring strict adherence to the expected structure for auto-discovery to function. Failing to properly configure the manifest or component organization will prevent commands, agents, and hooks from being found.

Related Skills

Explore More Software Engineering Skills→
goodnessibehgoodnessibeh
1

plugin-structure

Explain Claude Code plugin directory structure and plugin.json configuration.

Community
Advanced
hamzaPixlhamzaPixl
2

hook-development

Validate and automate Claude Code plugin hook events with prompt and command hooks.

Community
Advanced
iAMv1iAMv1
1

capability-injector

Inject modular capabilities into AI Coding Agents via plugins, hooks, and MCP servers.

Community
Advanced
PrirogativusPrirogativus

plugin-structure

Explain Claude Code plugin directory layout, component types, and naming conventions.

Community
Advanced