Skip to content

plugin-components-wrong-location

Plugin components should be in .claude/ not .claude-plugin/

Warning

Rule Details

Plugin components such as skills, agents, hooks, commands, mcpServers, lspServers, and outputStyles should be located in the .claude/ directory. The .claude-plugin/ directory is reserved for plugin metadata like plugin.json and marketplace.json. Placing components in .claude-plugin/ may cause them to not be discovered correctly by Claude Code.

Incorrect

Skills placed in .claude-plugin/ directory

yaml
my-plugin/
  .claude-plugin/
    plugin.json
    skills/         <-- wrong location
      my-skill/

Correct

Skills placed in .claude/ directory

yaml
my-plugin/
  .claude-plugin/
    plugin.json
  .claude/
    skills/           <-- correct location
      my-skill/

How To Fix

Move the component directories (skills, agents, hooks, commands, mcpServers, lspServers, outputStyles) from .claude-plugin/ to .claude/ and update any path references in plugin.json accordingly.

Options

This rule does not have any configuration options.

Resources

Version

Available since: v0.2.0