Where should I place my plugin component directories?

All component directories (commands, agents, skills, and hooks) must be placed at the plugin root. Do NOT put them inside the .claude-plugin/ directory, as they will not be discovered.

How do I validate my plugin before testing?

You should always run the /plugin-development:validate command. This performs schema and structure checks that catch approximately 90% of common development errors.

How do I fix hooks that aren't executing?

Most hook failures are caused by missing execution permissions or incorrect paths. Ensure you run 'chmod +x' on your scripts and use the ${CLAUDE_PLUGIN_ROOT} environment variable instead of relative paths.

What are the naming requirements for Claude Skills?

Skill names must use lowercase letters, numbers, and hyphens only, with a maximum of 64 characters. They cannot contain reserved words like 'anthropic' or 'claude', nor can they contain XML tags.

Claude Plugin Authoring

Name: Claude Plugin Authoring
Author: lopisan

bylopisan

0•

开发者工具

Guides the creation, validation, and debugging of Claude Code plugins using standardized schemas and best practices.

Claude Plugin Authoring serves as the definitive assistant for developers building extensions for the Claude Code ecosystem. It streamlines the development lifecycle by providing automated scaffolding for new plugins, real-time schema validation for manifests, and specialized troubleshooting for commands, agents, and hooks. By enforcing directory structure rules and validating skill frontmatter, this skill helps developers avoid common pitfalls like silent script failures or incorrect pathing, ensuring custom plugins are production-ready and compatible with the Claude environment.

主要功能

01Automated plugin scaffolding and component initialization

02Comprehensive frontmatter validation for skills and agents

03Real-time schema validation for manifests and hooks

04Directory structure auditing to prevent silent failures

05Local testing workflows for dev marketplace deployment

060 GitHub stars

使用场景

01Debugging permission issues and pathing errors in plugin hooks

02Validating plugin manifests before publishing to a marketplace

03Scaffolding a new plugin structure with custom slash commands

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopisan/claude-code-plugins plugin-authoring

For use in Claude.ai and ChatGPT

Download Skill