Plugin Structure
Handles everything around creating and organizing Claude Code plugins, from initial scaffolding to understanding the component discovery system. You'll use this when setting up the directory structure (commands, agents, skills, hooks), configuring the plugin.json manifest, or fixing path references with CLAUDE_PLUGIN_ROOT. The skill covers both the conventions (where files go, how they're auto-discovered) and the gotchas (manifest must be in .claude-plugin/, component directories stay at root level, never hardcode paths). If you're building a plugin or debugging why components aren't loading, this is your reference. It's comprehensive on structure but light on what individual components actually do once they're wired up.
- GitHub stars
- 340
- last updated
- May 19, 2026
Install
$ npx -y skills add tzachbon/smart-ralph --skill 'Plugin Structure' --agent claude-codeInstalls 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
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/tzachbon/smart-ralph
- Categories
- Frontend Development, Sales & Marketing
- License
- MIT
- First seen
- Jun 11, 2026
More from tzachbon/smart-ralph
All 28- Ralph Specum
- Ralph Specum Cancel
- Ralph Specum Design
- Ralph Specum Feedback
- Ralph Specum Help
- Ralph Specum Implement
- Ralph Specum Index
- Ralph Specum Refactor
- Ralph Specum Requirements
- Ralph Specum Research
- Ralph Specum Start
- Ralph Specum Status
- Ralph Specum Switch
- Ralph Specum Tasks
- Ralph Specum Triage
- Reality Verification
- Skill Development
- Smart Ralph
- Spec Workflow
- Speckit Workflow
- Command Development
- Communication Style
- Delegation Principle
- Hook Development
Recommended
More Frontend Development
hyperframes-cliheygen-com/hyperframesUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, 1.5Mskills.sh installshyperframesheygen-com/hyperframesMandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, expla1.5Mskills.sh installs
improve-codebase-architecturemattpocock/skillsScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.1.2Mskills.sh installssetup-matt-pocock-skillsmattpocock/skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the othe1.1Mskills.sh installshyperframes-animationheygen-com/hyperframesAll animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven 1Mskills.sh installshyperframes-keyframesheygen-com/hyperframesUse when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2754.8Kskills.sh installs