Can I define custom paths for my plugin components?

Yes, you can specify custom paths in the plugin.json manifest. Note that custom paths supplement the default directories rather than replacing them.

What is the required location for the plugin manifest?

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

Why should I use ${CLAUDE_PLUGIN_ROOT} instead of relative paths?

Using the ${CLAUDE_PLUGIN_ROOT} environment variable ensures your plugin remains portable across different operating systems and installation methods, as plugins may be installed in various locations.

How does Claude Code discover new commands or agents?

Claude Code uses an auto-discovery mechanism that automatically scans specific directories like commands/, agents/, and skills/ for markdown files and component definitions.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

开发者工具

Standardizes the creation and organization of Claude Code plugins using best practices for directory layout and manifest configuration.

This skill provides a comprehensive framework for building Claude Code plugins, ensuring developers follow standardized directory structures and naming conventions. It guides users through scaffolding plugin components like commands, agents, and hooks, while emphasizing portability through the use of environment variables. Whether you are building a simple utility or a full-featured integration, this skill ensures your plugin is discoverable, maintainable, and compatible across different operating systems and installation methods.

主要功能

015 GitHub stars

02Automated directory scaffolding for commands, agents, and skills

03Support for auto-discovery mechanisms and MCP server integration

04Manifest configuration guidance for plugin.json optimization

05Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}

06Standardized naming conventions for component-based organization

使用场景

01Migrating existing scripts into a formal, discoverable plugin structure

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

03Optimizing plugin manifests for cross-platform portability and auto-loading

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