claudelint

Appearance

plugin-missing-file ​

Files referenced in plugin.json must exist

Error

Rule Details ​

This rule checks that every path referenced in plugin.json actually exists. It validates skills, agents, commands, hooks, mcpServers, lspServers, and outputStyles paths. For hooks and server configs, only string paths are checked (inline objects are skipped). Missing referenced files will cause the plugin to fail at runtime when Claude Code tries to load the referenced resources.

Incorrect ​

Plugin referencing a skills directory that does not exist

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

Correct ​

Plugin with all referenced paths existing on disk

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

How To Fix ​

Create the missing files or directories at the paths specified in plugin.json. Alternatively, remove or correct any stale references that point to files that have been moved or deleted.

Options ​

This rule does not have any configuration options.

Resources ​

Version ​

Available since: v0.2.0