How does auto-discovery work in Claude Code?

Claude Code automatically scans specific directories like commands/, agents/, and skills/ for component files, registering them automatically without requiring manual manifest entries.

What is the purpose of ${CLAUDE_PLUGIN_ROOT}?

It is an environment variable used for portable path references, ensuring your plugin works across different operating systems and installation paths without hardcoded strings.

Can I use custom paths for plugin components?

Yes, you can specify custom paths in the plugin.json file. These paths will supplement the default auto-discovery directories rather than replacing them.

Where should the plugin manifest be located?

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

Plugin Structure & Scaffolding

Name: Plugin Structure & Scaffolding
Author: Microck

byMicrock

•

108

•

Developer Tools

Standardizes and scaffolds Claude Code plugin development through structured directory layouts and manifest configurations.

This skill provides comprehensive guidance on architecting Claude Code plugins, ensuring seamless integration through standardized directory structures and manifest-driven configurations. It assists developers in organizing commands, agents, skills, and hooks while implementing best practices for portability using the ${CLAUDE_PLUGIN_ROOT} variable. Whether you are scaffolding a new plugin from scratch or refactoring an existing project, this skill ensures your work follows auto-discovery conventions for a maintainable and portable codebase.

Key Features

01Automated plugin directory scaffolding and organization

02Auto-discovery setup for commands, agents, and skills

03Portable path management using ${CLAUDE_PLUGIN_ROOT}

04Standardized .claude-plugin/plugin.json manifest configuration

05108 GitHub stars

06Best practice guidance for naming conventions and component lifecycle

Use Cases

01Creating a new Claude Code plugin with a standard file structure

02Refactoring a disorganized plugin to ensure components are auto-discovered

03Configuring hooks and MCP servers within a portable plugin environment

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