What is the difference between a command and a skill in a plugin?

Commands are user-invoked via slash syntax, while skills are domain-specific capabilities that Claude Code autonomously activates based on the task context.

How does auto-discovery work in Claude Code plugins?

Claude Code automatically scans specific directories at the plugin root—such as commands/, agents/, and skills/—and loads any valid components it finds without requiring manual registration.

What is the correct location for the plugin manifest?

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

Claude Code Plugin Architecture & Scaffolding

Name: Claude Code Plugin Architecture & Scaffolding
Author: SwervoJake

bySwervoJake

0•

開発者ツール

Standardizes the development of Claude Code extensions through structured directory layouts, manifest configurations, and automated component discovery patterns.

The Plugin Structure skill serves as a comprehensive framework for developers looking to build robust extensions for Claude Code. It provides precise guidance on organizing commands, agents, skills, and hooks to ensure they are automatically discovered and loaded by the environment. By emphasizing best practices like portable path resolution via the ${CLAUDE_PLUGIN_ROOT} variable and standardized manifest formatting, this skill enables the creation of maintainable, production-ready plugins that integrate seamlessly across different operating systems and installation methods.

主な機能

01Standardized directory layout for automatic component discovery

02Best practices for naming conventions and plugin lifecycle management

03Component-based organization for commands, agents, skills, and hooks

04Comprehensive manifest (plugin.json) configuration and metadata guidance

050 GitHub stars

06Portable path management using ${CLAUDE_PLUGIN_ROOT} environment variables

ユースケース

01Refactoring existing local scripts and agents into a shareable, portable plugin format

02Scaffolding a new Claude Code plugin with the correct file hierarchy and manifest settings

03Troubleshooting component loading issues by verifying auto-discovery rules and path resolutions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio plugin-structure

For use in Claude.ai and ChatGPT

主な機能

01Standardized directory layout for automatic component discovery

02Best practices for naming conventions and plugin lifecycle management

03Component-based organization for commands, agents, skills, and hooks

04Comprehensive manifest (plugin.json) configuration and metadata guidance

050 GitHub stars

06Portable path management using ${CLAUDE_PLUGIN_ROOT} environment variables

ユースケース

01Refactoring existing local scripts and agents into a shareable, portable plugin format

02Scaffolding a new Claude Code plugin with the correct file hierarchy and manifest settings

03Troubleshooting component loading issues by verifying auto-discovery rules and path resolutions