Can I define custom paths for my plugin components?

Yes, you can specify custom paths in the plugin.json file. These paths supplement the default directories rather than replacing them, allowing for flexible organization.

What is the mandatory location for the plugin manifest?

The plugin.json manifest must be placed specifically within a directory named .claude-plugin/ at the root of your plugin folder.

Why is the ${CLAUDE_PLUGIN_ROOT} variable important?

It provides a portable way to reference internal files. Since plugins can be installed in different locations depending on the OS or user settings, using this variable prevents broken hardcoded paths.

How does Claude Code handle automatic component discovery?

Claude Code automatically scans the root-level commands/, agents/, and skills/ directories for markdown files and specific subdirectories to load functionality without manual registration.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

Developer Tools

Standardizes the directory layout and manifest configuration for building robust, portable Claude Code plugins.

The Claude Code Plugin Architect skill provides a comprehensive framework for developers to design, scaffold, and organize custom plugins. It enforces best practices for directory hierarchy, manifest configuration in plugin.json, and component organization including commands, agents, and skills. By utilizing standardized naming conventions and portable path references through the ${CLAUDE_PLUGIN_ROOT} variable, this skill ensures that your extensions are maintainable, easy to discover, and compatible across different operating systems and installation environments.

Key Features

01Portable path management using ${CLAUDE_PLUGIN_ROOT} variables

02Comprehensive manifest configuration for plugin.json metadata

03Guided implementation of commands, agents, skills, and hooks

045 GitHub stars

05Standardized directory layout for automatic component discovery

06Best practices for naming conventions and file organization

Use Cases

01Converting existing automation scripts into formal Claude Code plugins with manifest files

02Configuring complex MCP servers and event hooks for advanced workflow integration

03Scaffolding a new Claude Code plugin with a correct and discoverable folder structure

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