Why are my plugin hooks failing silently?

Common causes include missing executable permissions (chmod +x) or using relative paths instead of the required ${CLAUDE_PLUGIN_ROOT} variable.

Where should I place my plugin components like commands and skills?

All components must be placed at the plugin root directory. Do not place them inside the .claude-plugin/ folder, as they will not be auto-discovered.

Are there reserved words for naming skills?

Yes, names cannot contain 'anthropic' or 'claude'. Skill names must be lowercase, use hyphens for spaces, and be under 64 characters.

What is the Claude Code Plugin Authoring skill?

It is a specialized capability designed to help developers build, validate, and debug plugins and skills for the Claude Code environment by providing templates and automated checks.

How do I validate my plugin structure?

You can use the /plugin-development:validate command provided by this skill to identify schema errors, incorrect directory placements, and naming convention violations.

Claude Code Plugin Authoring

Name: Claude Code Plugin Authoring
Author: ArcBlock

byArcBlock

•

开发者工具

Guides the creation, validation, and debugging of custom Claude Code plugins and specialized agent skills.

关于

The Plugin Authoring skill is the definitive resource for developers building extensions for the Claude Code ecosystem. It enforces official best practices by providing automated scaffolding for commands, agents, and hooks, while performing real-time schema validation to prevent common configuration errors. By offering a structured workflow for diagnosis, execution, and auditing, this skill ensures that custom plugins are properly discovered, executable, and ready for deployment in local or marketplace environments.

主要功能

Automated scaffolding for plugins, commands, skills, and agents
Best practice guidance for executable hooks and environment variables
5 GitHub stars
Seamless integration with the plugin-reviewer agent for deep audits
Real-time manifest and schema validation for plugin.json
Standardized directory structure enforcement and error checking

使用场景

Troubleshooting silent failures in custom commands or hook scripts
Validating plugin manifests and directory layouts before release
Scaffolding a new Claude Code plugin structure from scratch

关于

主要功能

Automated scaffolding for plugins, commands, skills, and agents
Best practice guidance for executable hooks and environment variables
5 GitHub stars
Seamless integration with the plugin-reviewer agent for deep audits
Real-time manifest and schema validation for plugin.json
Standardized directory structure enforcement and error checking

使用场景

Troubleshooting silent failures in custom commands or hook scripts
Validating plugin manifests and directory layouts before release
Scaffolding a new Claude Code plugin structure from scratch