What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is a dynamic environment variable used to reference the plugin's root directory, ensuring that file paths remain portable across different operating systems and installation methods.

Where should the plugin.json file be located?

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

How does Claude Code discover new commands?

Claude Code automatically scans the commands/ directory for any .md files with valid YAML frontmatter and loads them as native slash commands.

Can I use custom paths for my plugin components?

Yes, you can specify custom relative paths for commands, agents, and hooks within the plugin.json manifest to supplement the default directory structure.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

開発者ツール

Provides comprehensive guidance on scaffolding, organizing, and configuring Claude Code plugins using standardized directory structures and manifests.

This skill empowers developers to build well-structured and maintainable Claude Code plugins by providing clear patterns for directory layout, manifest (plugin.json) configuration, and component discovery. It covers essential architectural concepts like the ${CLAUDE_PLUGIN_ROOT} variable, auto-discovery mechanisms for commands and skills, and best practices for organizing agents, hooks, and MCP servers. Whether you are scaffolding a new project or optimizing an existing one, this skill ensures your tools integrate seamlessly with the Claude Code ecosystem.

主な機能

01Portable path management using ${CLAUDE_PLUGIN_ROOT} variables

02Automatic component discovery patterns for seamless integration

03Standardized directory scaffolding for commands, agents, and skills

041 GitHub stars

05Manifest configuration guidance for plugin.json and .mcp.json

06Best practices for naming conventions and component modularity

ユースケース

01Migrating local scripts and utilities into a formal, portable plugin structure

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

03Optimizing plugin discovery and configuring event-driven hooks or MCP servers

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