Does Claude Code automatically discover new commands?

Yes, Claude Code automatically scans the commands/, agents/, and skills/ directories for valid components, provided they follow the standard naming and file format conventions.

Where should the plugin manifest file be located?

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

How do I ensure plugin paths work across different operating systems?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all intra-plugin path references to ensure portability across macOS, Linux, and Windows.

What is the recommended naming convention for plugin files?

All directory and file names should use kebab-case (lowercase with hyphens) to ensure consistency and compatibility across the Claude Code ecosystem.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: C0ntr0lledCha0s

byC0ntr0lledCha0s

•

Herramientas para Desarrolladores

Provides comprehensive guidance and scaffolding patterns for building, organizing, and maintaining standardized Claude Code plugins.

This skill empowers developers to build robust Claude Code plugins by enforcing best practices for directory layout and component organization. It provides detailed instructions for configuring the plugin.json manifest, setting up auto-discovery for commands and agents, and utilizing the ${CLAUDE_PLUGIN_ROOT} environment variable for portable pathing. Whether you are scaffolding a new project or refactoring an existing one, this skill ensures your plugin integrates seamlessly with the Claude Code ecosystem through standardized naming conventions and efficient component loading patterns.

Características Principales

01Detailed manifest (plugin.json) configuration guidance

02Naming convention enforcement for kebab-case components

03Standardized directory layout scaffolding and organization

04Portable path management using ${CLAUDE_PLUGIN_ROOT}

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

062 GitHub stars

Casos de Uso

01Troubleshooting component discovery and path resolution issues in complex plugins

02Migrating existing automation scripts into a structured, discoverable plugin format

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

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add c0ntr0lledcha0s/claude-code-plugin-automations plugin-structure

For use in Claude.ai and ChatGPT

Download Skill