plugin-structure

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

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/nakaj1214/trader --skill plugin-structure-nakaj1214
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: plugin-structure
Source: https://github.com/nakaj1214/trader/tree/main/.claude/skills/plugin-dev/plugin-structure
Command: npx skills add https://github.com/nakaj1214/trader --skill plugin-structure-nakaj1214

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) and examples (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance on building robust and well-organized Claude Code plugins, eliminating confusion around directory structure, manifest configuration, and component organization.

Core Features & Use Cases

  • Plugin Scaffolding: Learn the standard directory layout for auto-discovery.
  • Manifest Configuration: Understand all fields in plugin.json for metadata and path definitions.
  • Component Organization: Best practices for structuring commands, agents, skills, and hooks.
  • Portable Paths: Master the use of ${CLAUDE_PLUGIN_ROOT} for reliable referencing.
  • Use Case: You need to create a new plugin for code review. This Skill will guide you through setting up the plugin.json, organizing your commands and skills, and ensuring your scripts can be referenced correctly regardless of installation location.

Quick Start

Use the plugin-structure skill to understand how to organize commands within a 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?โ–ผ

Claude Code plugin auto-discovery requires a standard directory layout. You must organize components like commands, agents, skills, and hooks into specific folders so the system can automatically detect and load them without manual configuration.

What is the best way to configure paths in a plugin manifest?โ–ผ

Configuring paths in a plugin manifest requires using the portable variable `${CLAUDE_PLUGIN_ROOT}`. This ensures your script references resolve correctly regardless of where the plugin is actually installed on the system.

How does plugin.json manifest configuration work for Claude Code?โ–ผ

The `plugin.json` manifest configuration works by defining essential plugin metadata and path variables. It tells Claude Code how to locate and interact with your organized components, hooks, and commands during execution.

Do I need a specific file naming convention for Claude Code plugin components?โ–ผ

Yes, Claude Code plugin components require specific file naming conventions for proper auto-discovery. Following these standard naming rules ensures your commands, agents, and hooks are correctly recognized by the platform.

Can I use this Skill to scaffold a code review plugin from scratch?โ–ผ

Yes, you can scaffold a code review plugin from scratch using this guidance. It walks you through setting up the `plugin.json` manifest, organizing directories, and ensuring portable script references for your specific use case.