Where should the plugin manifest be located?

The plugin.json manifest must be placed within the .claude-plugin/ directory at the root of your plugin to be recognized by Claude Code.

Does Claude Code automatically find my plugin commands?

Yes, Claude Code uses an auto-discovery mechanism that automatically scans the commands/, agents/, and skills/ directories at the plugin root.

What components can I include in a Claude Code plugin?

Plugins can include slash commands, specialized subagents, auto-activating skills, event hooks (JSON), and MCP server definitions.

How do I ensure my plugin works on different operating systems?

Use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal path references instead of hardcoded absolute or relative paths.

What naming convention should I use for plugin files?

It is best practice to use kebab-case (lowercase with hyphens) for all directory names and component files to ensure broad compatibility.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Microck

byMicrock

•

開発者ツール

Guides developers through scaffolding, organizing, and configuring standardized Claude Code plugin architectures and manifests.

This skill provides comprehensive guidance on building Claude Code plugins using standardized directory structures and industry best practices. It helps developers set up manifest files, organize components like commands and agents, implement hooks, and ensure portability using system variables. Whether you're scaffolding a new plugin from scratch or refactoring an existing project, this skill ensures your architecture follows the official auto-discovery patterns and naming conventions for seamless integration with the Claude Code environment.

主な機能

01Scaffold standardized directory layouts for commands, agents, and skills

0289 GitHub stars

03Configure plugin.json manifests with required and recommended metadata

04Implement portable path references using ${CLAUDE_PLUGIN_ROOT}

05Set up event-driven hooks and MCP server definitions

06Optimize component organization for Claude Code's automatic discovery mechanism

ユースケース

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

02Migrating hardcoded paths to portable environment variables for cross-platform support

03Configuring complex manifests with custom component paths and auto-discovery overrides

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