What is the correct file structure for a Claude Code plugin?

The .claude-plugin directory should only contain metadata like plugin.json. All components like commands, agents, skills, and hooks must be located at the plugin root for auto-discovery.

How do I ensure my plugin hooks execute correctly?

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for paths instead of relative paths, and ensure all script files have executable permissions set via chmod +x.

Are there naming restrictions for Claude Code skills?

Yes. Skill names must use only lowercase letters, numbers, and hyphens, stay under 64 characters, and cannot contain reserved words like 'anthropic' or 'claude'.

Why is the validation command recommended before testing?

The /plugin-development:validate command catches 90% of common issues, such as manifest schema errors or component discovery problems, which often cause silent failures during local testing.

Plugin Authoring & Development

Name: Plugin Authoring & Development
Author: ABCFed

byABCFed

•

Developer Tools

Streamlines the creation, modification, and debugging of Claude Code plugins using standardized schemas, templates, and validation workflows.

This skill acts as the authoritative guide for building Claude Code extensions, providing a structured environment for developing commands, agents, skills, and hooks. It automates the scaffolding process and enforces Anthropic's best practices through rigorous validation tools that catch common errors like incorrect directory placement or invalid naming conventions. By offering real-time repository diagnosis and a suite of specialized development commands, it ensures that developers can build, test, and package high-quality plugins that integrate seamlessly with the Claude Code ecosystem.

Key Features

01Deep audit integration with the plugin-reviewer agent

02Built-in guardrails for path handling and script execution permissions

03Pre-defined templates for slash commands, agents, and skills

04Real-time validation of plugin manifests and directory structures

05Automated scaffolding for new plugins and individual components

0616 GitHub stars

Use Cases

01Troubleshooting and fixing silent failures in existing plugin hooks

02Converting custom workflows into distributable Claude Code skills

03Scaffolding a new Claude Code plugin structure from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add abcfed/claude-marketplace plugin-authoring

For use in Claude.ai and ChatGPT

Download Skill