Skip to content

plugin-missing-component-paths

Plugin component paths should start with ./ to be explicit about their location

Warning

Rule Details

Component paths in plugin.json (skills, agents, commands, outputStyles, hooks, mcpServers, lspServers) should start with "./" to make it explicit that they are relative to the plugin root. Paths without the leading "./" prefix are ambiguous and may be misinterpreted. This rule is auto-fixable and will prepend "./" to paths that lack it.

Incorrect

Skills path missing the ./ prefix

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My plugin",
  "skills": [
    ".claude/skills"
  ]
}

Correct

Skills path with the ./ prefix

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My plugin",
  "skills": [
    "./.claude/skills"
  ]
}

How To Fix

Prepend "./" to any component path that does not already start with it. For example, change ".claude/skills" to "./.claude/skills".

Options

This rule does not have any configuration options.

Resources

Version

Available since: v0.2.0