Why should I use ${CLAUDE_PLUGIN_ROOT} in my configuration?

Using ${CLAUDE_PLUGIN_ROOT} ensures your plugin is portable across different operating systems and installation methods by avoiding hardcoded absolute paths.

How does Claude Code discover new commands and agents?

Claude Code uses an auto-discovery mechanism that scans the commands/, agents/, and skills/ directories at the plugin root for markdown and configuration files.

What are hooks in a Claude Code plugin?

Hooks are event handlers defined in hooks.json or the manifest that execute automatically in response to events like tool use, session start, or user prompts.

What is the required location for the plugin manifest?

The manifest file, named plugin.json, must be located within the .claude-plugin/ directory at the root of your plugin.

Can I include custom scripts within a Claude Code skill?

Yes, skills are organized in subdirectories within the skills/ folder and can include their own scripts, references, and assets alongside the required SKILL.md file.

Claude Code Plugin Architecture Guide

Name: Claude Code Plugin Architecture Guide
Author: Microck

byMicrock

•

学习与文档

Standardizes the creation and organization of Claude Code plugins through structured directory layouts and manifest configurations.

This skill provides comprehensive guidance on the architecture and organization of Claude Code plugins, ensuring developers build extensions that are portable and maintainable. It details the mandatory directory structure, the specific configuration requirements for the plugin.json manifest, and the implementation of core components like slash commands, subagents, and auto-activating skills. By following these established patterns and using portable pathing like ${CLAUDE_PLUGIN_ROOT}, developers can leverage Claude Code's auto-discovery mechanisms for seamless tool integration.

主要功能

01Portable path resolution using the ${CLAUDE_PLUGIN_ROOT} variable

02Comprehensive manifest configuration for plugin metadata and paths

03Implementation patterns for commands, agents, skills, and hooks

0481 GitHub stars

05Standardized directory layout for automatic component discovery

06Guidance on MCP server integration and naming conventions

使用场景

01Scaffolding and bootstrapping a new Claude Code plugin project

02Organizing complex plugins with multiple subagents and specialized skills

03Refactoring legacy scripts into standardized Claude Code components

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