claude-code - 💡(How to fix) Fix [DOCS] Missing 'name' field in SKILL.md example in plugins quickstart docs [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#47816Fetched 2026-04-15 06:41:31
View on GitHub
Comments
0
Participants
1
Timeline
6
Reactions
0
Participants
Timeline (top)
labeled ×5closed ×1

Error Message

in the frontmatter. Without it, Claude Code throws error:

RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/plugins

Section/Topic

Add a skill

Current Documentation

The doc currently says to put following in SKILL.md file


description: Greet the user with a friendly message disable-model-invocation: true

Greet the user warmly and ask how you can help them today.

What's Wrong or Missing?

The SKILL.md example is missing the required 'name' field in the frontmatter. Without it, Claude Code throws error: "Skill must provide a name"

Suggested Improvement

Add name key also in example. Correct SKILL.md file is


name: hello description: Greet the user with a friendly message disable-model-invocation: true

Greet the user warmly and ask how you can help them today.

Impact

Low - Minor confusion or inconvenience

Additional Context

No response

extent analysis

TL;DR

Update the SKILL.md file example in the documentation to include the required 'name' field in the frontmatter.

Guidance

  • Verify that the 'name' field is included in the SKILL.md file frontmatter for all skills to prevent the "Skill must provide a name" error.
  • Update the documentation at https://code.claude.com/docs/en/plugins to reflect the correct SKILL.md file format, including the 'name' field.
  • Test the updated SKILL.md file with Claude Code to ensure it resolves the error.
  • Review other documentation sections for similar missing or outdated information.

Example

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---
Greet the user warmly and ask how you can help them today.

Notes

This fix assumes that the 'name' field is the only missing required field in the SKILL.md file frontmatter. Additional fields may be required depending on the specific use case.

Recommendation

Apply workaround: Update the SKILL.md file example in the documentation to include the required 'name' field, as this is a minor issue with low impact and can be easily resolved with a documentation update.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING