Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.305 ·

claude plugin validate --profile directory checks a plugin against the plugin directory's rules

claude plugin validate gains --profile directory, which checks a plugin folder for the plugin directory's submission rules and can fail a CI run

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

Unclear It is not stated what the loading check rejects, or whether the folder-layout check runs for everyone.

What

A plugin is an add-on package for Claude Code. claude plugin validate is the command that checks a plugin for mistakes. It now has a new option, --profile <name>, and directory is the only choice. claude plugin validate <path> --profile directory reads the plugin folder on disk and checks it against the rules of the plugin directory, the place plugins are submitted to. The --profile option did not exist in the previous release.

  • Rules checked include README_MISSING, LICENSE_MISSING, ICON_MISSING, PRIVACY_URL_MISSING, PATH_TRAVERSAL, the plugin name, whether the hooks and MCP files are valid JSON, and stray system files such as .DS_Store and Thumbs.db. Each finding has a code, a severity and text saying how to fix it.
  • Errors are blocking: the command exits with code 1 when the plugin directory would refuse the submission, for example when the README is missing.
  • The command also exits with code 1 when a check could not be made, for example when there are more than 16 MCP or hooks files.
  • --strict makes warnings fail the run too. The output suggests running --profile directory --strict on a fresh checkout in CI (an automated build system).
  • JSON output includes a section for the directory results, and the output describes the required plugin layout.
  • The output states that the directory's safety scan and policy review are not run by this command.
  • Plugin loading also takes a new containedIn option and now runs a check on SKILL.md, hooks/hooks.json and settings.json.

Why

Plugin authors can check locally, or in an automated build, whether a plugin is likely to be refused by the plugin directory before submitting it. Passing this check does not mean the plugin will pass the directory's safety scan or policy review, since those are not run.

Read from
Names in the bundleclaude plugin validate
What the documentation says
claude plugin validate Claude Code changelog modified, high confidence * Removed the notes from `claude plugin validate` that predicted where a mod's hooks would run see the edit
--profile Desktop application modified, high confidence * **IAM Identity Center**: add the profile's [IAM Identity Center settings](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) in place of `credential_process`. Run `aws sso login --profile corp` in a terminal before … see the edit
claude plugin validate Add components to a plugin modified, high confidence To include instructions in a plugin, write them as a skill. Claude Code doesn't load a `CLAUDE.md` at the plugin root, and `claude plugin validate` warns `CLAUDE.md at the plugin root is not loaded as project context`. see the edit
claude plugin validate Troubleshoot plugins modified, high confidence ### `claude plugin validate` reports errors see the edit
--profile On a remote host without a browser: modified, medium confidence ant auth login --profile work 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 doubtIt is not stated what the loading check rejects, or whether the folder-layout check runs for everyone.
Anthropic's documentation agreesclaude plugin validate on Claude Code changelog

See this entry in the whole of v2.1.305 →

Feedback