Where should I place my subagent definitions?

Subagent definitions should be placed in the agents/ directory as markdown files located at the root level of your plugin.

Why should I use ${CLAUDE_PLUGIN_ROOT} in my plugin?

It ensures your plugin remains portable across different operating systems and installation methods by resolving paths relative to the plugin's actual location.

How does Claude Code find my custom plugin commands?

Claude Code automatically scans the commands/ directory at the plugin root for markdown files containing valid YAML frontmatter.

Can I use custom paths for plugin components instead of the defaults?

Yes, you can specify custom paths in the plugin.json manifest, which will supplement the default auto-discovery directories.

What is the purpose of the .claude-plugin/ directory?

It contains the essential plugin.json manifest file that defines the plugin's metadata, versioning, and configuration.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

110

•

Developer Tools

Provides standardized patterns and architectural guidance for building, scaffolding, and organizing Claude Code plugins.

The Plugin Structure skill serves as a comprehensive architectural blueprint for developers building Claude Code extensions. It streamlines the plugin development lifecycle by providing immediate guidance on directory layouts, manifest configuration within the .claude-plugin directory, and the integration of specialized components like commands, agents, and MCP servers. By enforcing best practices such as the use of ${CLAUDE_PLUGIN_ROOT} for portable path resolution and standardized naming conventions, it ensures that custom plugins are maintainable, portable, and seamlessly discovered by the Claude Code environment.

Key Features

01Manifest (plugin.json) configuration guidance

02Portable path resolution using ${CLAUDE_PLUGIN_ROOT}

03110 GitHub stars

04Standardized directory layout scaffolding

05Automated component discovery patterns

06Best practices for commands, agents, and skills organization

Use Cases

01Scaffolding a new Claude Code plugin from scratch with the correct hierarchy

02Converting hardcoded plugin paths into portable environment variables for cross-platform support

03Organizing complex plugin components into a maintainable, auto-discoverable structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill