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.233 ·

/doctor now checks skills for broken frontmatter

/doctor now spots skills whose frontmatter fails to parse and offers to repair it.

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

The setup-health check run by /doctor scans project and user SKILL.md files for a YAML frontmatter block that fails to parse. Such a skill still loads, but every field is dropped: the name falls back to the directory name, the description to the first line of the body, and allowed-tools, model and disable-model-invocation stop applying with no warning at all. The check offers the frontmatter repair.

Details
  • Points at claude plugin validate <path> for checking many skills at once.
  • The skill's own description was updated to advertise the new check.
Evidence

Malformed skill frontmatter.

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
Names in the bundle/doctor
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 /doctor, on CLI reference. | `claude doctor` | Print read-only installation and settings diagnostics from the terminal without starting a session, including install health, settings-file validation errors, and Remote Control eligibility. For the in-session setup che… cli-reference see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up /doctor, on CLI reference.
Anthropic's release notes agreeImproved claude plugin validate to check a bare .claude/skills directory, reporting SKILL.md files whose frontmatter fails to parse

See this entry in the whole of v2.1.233 →

Feedback