Can I define multiple agents in a single plugin?

Yes, you can define multiple specialized agents by placing their respective markdown definition files in the agents/ directory.

Where should the plugin manifest be located?

The plugin.json manifest must be placed within the .claude-plugin/ directory at the root level of your plugin.

How do I ensure my plugin is portable across different systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for internal path references instead of hardcoded absolute paths.

Does Claude Code automatically load my plugin commands?

Yes, Claude Code uses an auto-discovery mechanism that automatically loads all .md files located in the commands/ directory at the plugin root.

Claude Code Plugin Structure Guide

Name: Claude Code Plugin Structure Guide
Author: Activer007

byActiver007

0•

Developer Tools

Guides the creation and organization of Claude Code plugins using standardized directory layouts and manifest configurations.

This skill provides comprehensive architectural guidance for developers building extensions for Claude Code. It outlines the essential requirements for plugin development, including the correct placement of the plugin.json manifest, the hierarchical organization of commands, agents, and hooks, and the implementation of portable path references using the ${CLAUDE_PLUGIN_ROOT} variable. By following these standardized patterns, developers can ensure their plugins are maintainable, portable, and compatible with Claude Code's automated component discovery mechanism.

Key Features

01Automated component discovery protocols

02Portable path resolution via environment variables

03Component-based organization patterns

04Standardized directory layout scaffolding

05Manifest-driven configuration guidance

060 GitHub stars

Use Cases

01Scaffolding a new Claude Code plugin with correct folder structures

02Configuring event hooks and MCP servers for custom workflows

03Organizing scripts and subagents into a distributable plugin format

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills command-name

For use in Claude.ai and ChatGPT

Download Skill