Where should the plugin manifest be located?

The manifest must be named plugin.json and must be placed inside the .claude-plugin/ directory at the root of your plugin.

What is the difference between a Skill and a Command?

Commands are manually invoked by the user via slash commands, whereas Skills are autonomously activated by Claude when the task context matches the skill's description.

How does Claude Code discover new commands?

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

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is a portable environment variable used for intra-plugin path references, ensuring your scripts and hooks work regardless of the user's OS or installation path.

Can I use custom paths for my plugin components?

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

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

開発者ツール

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

This skill provides comprehensive guidance for developers looking to build, scaffold, or optimize the architecture of Claude Code plugins. It covers essential architectural requirements, including the mandatory .claude-plugin/plugin.json manifest, automatic component discovery for commands and agents, and the implementation of portable paths using the ${CLAUDE_PLUGIN_ROOT} variable. By following these patterns, developers can create maintainable, cross-platform plugins that integrate seamlessly with Claude Code's native capabilities.

主な機能

01Portable path management using ${CLAUDE_PLUGIN_ROOT} references

02Component-based organization for commands, agents, skills, and hooks

03Best practices for file naming and cross-platform plugin portability

04Standardized directory layout for automatic component discovery

051 GitHub stars

06Manifest configuration guidance for .claude-plugin/plugin.json

ユースケース

01Refactoring existing scripts into a valid Claude Code plugin structure for distribution

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

03Troubleshooting component discovery and path resolution issues within custom plugins

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