Does Claude Code automatically find my plugin commands?

Yes, Claude Code uses an auto-discovery mechanism that automatically loads markdown files located in the commands/, agents/, and skills/ directories at the plugin root.

Can I use custom directory names for my components?

Yes, you can specify custom paths for commands, agents, and hooks in the plugin.json manifest, though these supplement rather than replace the default directories.

Where should the plugin manifest be located?

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

How do I ensure my plugin paths are portable?

You should always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all intra-plugin path references to ensure they work across different operating systems and installation methods.

Claude Plugin Architect

Name: Claude Plugin Architect
Author: ffalor

byffalor

0•

Developer Tools

Standardizes Claude Code plugin development by providing comprehensive guidance on directory layout, component organization, and manifest configuration.

This skill serves as the definitive reference for building Claude Code plugins, ensuring developers follow standardized directory structures and manifest requirements for seamless integration. It provides expert guidance on organizing commands, agents, skills, and hooks while mastering the auto-discovery mechanism and portable path references. By utilizing this skill, developers can create maintainable, portable, and full-featured extensions that leverage the `${CLAUDE_PLUGIN_ROOT}` environment variable and follow Claude Code's architectural best practices.

Key Features

01Component organization for commands, agents, and skills

02Manifest (plugin.json) configuration assistance

030 GitHub stars

04Auto-discovery mechanism optimization

05Portable path management using ${CLAUDE_PLUGIN_ROOT}

06Standardized directory layout scaffolding

Use Cases

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

02Refactoring existing plugins to meet standardized naming and location conventions

03Configuring advanced plugin features like hooks and MCP server integrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ffalor/agentic-coding plugin-structure

For use in Claude.ai and ChatGPT

Key Features

01Component organization for commands, agents, and skills

02Manifest (plugin.json) configuration assistance

030 GitHub stars

04Auto-discovery mechanism optimization

05Portable path management using ${CLAUDE_PLUGIN_ROOT}

06Standardized directory layout scaffolding

Use Cases

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

02Refactoring existing plugins to meet standardized naming and location conventions

03Configuring advanced plugin features like hooks and MCP server integrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ffalor/agentic-coding plugin-structure

For use in Claude.ai and ChatGPT