This skill should be used when the user asks to "create a plugin", "scaffold a plugin", "understand plugin structure", "organize plugin components", "set up plugin.json", "use ${CLAUDE_PLUGIN_ROOT}", "add commands/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.
69
53%
Does it follow best practices?
Impact
100%
1.96xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/plugin-dev/skills/plugin-structure/SKILL.mdCorrect plugin directory structure
Manifest location
0%
100%
Components at root
0%
100%
No extra component dirs
100%
100%
Plugin name kebab-case
100%
100%
Semantic version
100%
100%
Command YAML frontmatter
0%
100%
Agent YAML frontmatter
0%
100%
Skill uses SKILL.md
0%
100%
SKILL.md frontmatter
0%
100%
Kebab-case file names
100%
100%
Skill in subdirectory
0%
100%
Portable path references and hook configuration
CLAUDE_PLUGIN_ROOT in hook commands
33%
100%
No hardcoded absolute paths
100%
100%
No bare relative paths in commands
100%
100%
CLAUDE_PLUGIN_ROOT in MCP server args
33%
100%
PreToolUse for Write event
100%
100%
Stop event for cleanup
100%
100%
Valid hook event names
100%
100%
Hook structure format
70%
100%
Portability explanation
37%
100%
MCP server config structure
100%
100%
Plugin manifest configuration and custom paths
Commands field is array
0%
100%
Default commands path included
25%
100%
New directories in commands array
30%
100%
Paths start with ./
0%
100%
No absolute paths in manifest
100%
100%
Version bumped to stable
0%
100%
Version semver format
100%
100%
License field present
100%
100%
Homepage field present
0%
100%
Keywords expanded
100%
100%
Command files have YAML frontmatter
100%
100%
New directory names kebab-case
100%
100%
48aa435
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.