Can I define custom paths for my plugin components?

Yes, you can supplement the default directories by specifying custom relative paths in the 'commands', 'agents', or 'skills' fields within your plugin.json manifest.

How does Claude Code find my plugin's commands and agents?

Claude Code uses an auto-discovery mechanism that scans root-level directories named commands/, agents/, and skills/ for compatible Markdown and configuration files.

What is the correct format for a Claude Code skill?

A skill should reside in its own subdirectory within the skills/ folder and must contain a SKILL.md file with appropriate YAML frontmatter defining its name and version.

Where must the plugin manifest be located?

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

Why is the ${CLAUDE_PLUGIN_ROOT} variable important?

It provides a portable way to reference files within your plugin, ensuring scripts and assets work correctly regardless of the user's OS or where they installed the plugin.

Claude Code Plugin Architect

Name: Claude Code Plugin Architect
Author: Activer007

byActiver007

•

개발자 도구

Standardizes the creation, scaffolding, and organization of Claude Code plugins using architectural best practices.

This skill provides expert guidance on the standardized directory layout and manifest configuration required for building robust Claude Code plugins. It assists developers in scaffolding new projects, organizing modular components like commands and agents, and implementing portable path references using the ${CLAUDE_PLUGIN_ROOT} environment variable. By following these established patterns, developers ensure their plugins integrate seamlessly with Claude Code's auto-discovery mechanism, remain maintainable, and function reliably across different operating systems and installation environments.

주요 기능

01Automated directory scaffolding for commands, agents, and skills

02Standardized plugin.json manifest configuration and metadata

035 GitHub stars

04Event hook and MCP server registration guidance

05Portable path management using ${CLAUDE_PLUGIN_ROOT}

06Component auto-discovery optimization for faster loading

사용 사례

01Configuring complex plugin manifests with custom component paths and event hooks

02Restructuring an existing project to follow official Claude Code architectural conventions

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

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