Follow Discord
Sweep 25 Sep 2026 · 19:33Z Build v2.1.283 504 read Stable v2.1.274 Latest v2.1.283 Next v2.1.283 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.283 ·

Plugin validation checks more manifest paths

claude plugin validate now checks paths for more plugin parts and flags a .json path that is really a folder

Use it now Improvements
JSON All of v2.1.283
Use it nowTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
PluginsArea: what it touches
ImprovementsKind: in v2.1.283,
What probably matters to youSection of the release
What

A plugin's manifest is the file that tells Claude Code where the plugin's parts live. claude plugin validate now checks these paths in the manifest:

  • commands, hooks, agents, skills, mcpServers, workflows and types, as before
  • outputStyles, themes, monitors and lspServers, which were not checked before
  • the same keys written in the experimental.<key> form

There is also a new error. If a hooks, monitors, lspServers or mcpServers path ends in .json but is actually a folder, validation reports that it "must point to a JSON file".

Why

Plugin authors see missing or wrong paths for more kinds of plugin parts before their users run into them. For example, a missing MCP servers file is otherwise skipped silently, so none of its servers load.

Read from
Names in the bundleclaude plugin validate
What the documentation says
claude plugin validate Test plugins with evals modified, high confidence This page is for plugin and skill authors who have a working plugin and want to test its behavior, and for teams that gate plugin changes in CI. Its case format is separate from the `evals/evals.json` file the [skill-creator plugin](/docs/… see the edit
claude plugin validate Extend Claude with skills modified, high confidence To find `SKILL.md` files whose frontmatter doesn't parse, run [`claude plugin validate`](/docs/en/plugins/cli-reference#validate-a-directory) on the skills directory, for example `claude plugin validate .claude/skills` for project skills o… see the edit
claude plugin validate Create custom subagents modified, high confidence To find files in an `agents` directory whose frontmatter doesn't parse, run `claude plugin validate` against the directory, for example `.claude/agents` or `~/.claude/agents`. Claude Code checks only [the directory you name](/docs/en/plugi… see the edit
claude plugin validate Submit your plugin modified, high confidence Before you open the portal, work through the [plugin pre-submission checklist](/docs/plugins/pre-submission-checklist). It covers what the directory's checks look for in `plugin.json`, the README, the license, and the rest of the plugin fo… see the edit
claude plugin validate Create custom skills modified, high confidence To check the skill's contents rather than the archive shape, [validate it before uploading](#before-uploading) with `skills-ref validate` or `claude plugin validate`, or ask Claude to review the folder against the [Agent Skills specificati… see the edit
claude plugin validate Publish and distribute a plugin modified, high confidence * **Run `claude plugin validate ./your-plugin --strict` in your shell**: replace `./your-plugin` with the path to your plugin directory. The command catches manifest errors locally; [plugin validate](/docs/en/plugins/cli-reference#plugin-v… see the edit
claude plugin validate Plugin structure and testing modified, medium confidence Before you submit the plugin to the directory, run `claude plugin validate ./expense-reports`, then select **Validate** in the [developer portal](https://claude.ai/directory/manage). The portal runs every validation check, and [Run the che… see the edit
claude plugin validate Connector pre-submission checklist modified, low confidence Run `claude plugin validate` on plugins. For MCP servers, exercise every tool through the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) and as a [custom connector in Claude](/docs/connectors/building/testing). see the edit
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up claude plugin validate, on Plugin manifest reference. If you leave one of these variables outside quotes in a shell-form command in a hooks file, `claude plugin validate` warns about it unless the hook sets [`shell`](/docs/en/hooks#command-hook-fields) to `"powershell"`. plugins/manifest-reference see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtThe full list of checked keys comes from reading the code, not from running the validator.
Anthropic's documentation agreesclaude plugin validate on Test plugins with evals
Anthropic's release notes agreeFixed claude plugin validate saying Claude Code accepts a plugin or marketplace name it cannot install; such names in marketplace.json now…

See this entry in the whole of v2.1.283 →

Feedback