Can I use custom paths for plugin components?

Yes, you can specify custom paths in the plugin.json manifest using the commands, agents, or skills fields, which will supplement the default directory locations.

What is the required location for the plugin manifest?

The plugin.json manifest must always be located within the .claude-plugin/ directory at the root of your plugin to be recognized by Claude Code.

How do I reference files within my plugin portably?

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

Does Claude Code automatically discover new commands?

Yes, Claude Code automatically scans the commands/ directory for .md files with valid frontmatter and registers them as slash commands during the discovery process.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

Developer Tools

Guides the creation and organization of Claude Code plugins using standardized directory layouts and manifest configurations.

This skill provides expert guidance for developers building Claude Code extensions, ensuring every plugin follows the official standardized directory pattern. It helps users scaffold new plugins, configure the critical plugin.json manifest, and organize components like commands, agents, and skills for automatic discovery. By implementing best practices for naming conventions and portable path references using the ${CLAUDE_PLUGIN_ROOT} variable, this skill ensures that developed plugins are maintainable, portable across different operating systems, and integrate seamlessly with the Claude Code ecosystem.

Key Features

01Standardized directory scaffolding for commands, agents, skills, and hooks

02Component auto-discovery and naming convention enforcement

03Automated manifest (plugin.json) configuration and metadata optimization

04Integration patterns for MCP servers and event-driven hooks

05Implementation of portable path references using ${CLAUDE_PLUGIN_ROOT}

065 GitHub stars

Use Cases

01Refactoring existing scripts into a formal, portable plugin structure for distribution

02Scaffolding a new Claude Code plugin from scratch with the correct folder hierarchy and manifest

03Configuring complex event hooks and MCP server definitions within a plugin manifest

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills command-name

For use in Claude.ai and ChatGPT

Download Skill