Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] argument-hint frontmatter not displayed for plugin skills in slash command autocomplete [2 comments, 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#46626•Fetched 2026-04-12 13:37:19
View on GitHub
Comments
2
Participants
1
Timeline
8
Reactions
0
Author
sieg-zeonsieg-zeon
Participants
sieg-zeonsieg-zeon
Timeline (top)
labeled ×5commented ×2renamed ×1

Code Example

---
name: my-skill
description: "My skill description"
argument-hint: "<arg1> [--option]"
---
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

argument-hint in SKILL.md frontmatter is not displayed in the slash command autocomplete UI for plugin skills, while it works correctly for project-level skills (.claude/skills/).

Both use the exact same SKILL.md format and frontmatter structure — the only difference is where the file is located.

Steps to Reproduce

  1. Create a plugin with a skill that has argument-hint in frontmatter:
---
name: my-skill
description: "My skill description"
argument-hint: "<arg1> [--option]"
---

  1. Load the plugin via --plugin-dir ./plugins/my-plugin or install from a marketplace

  2. Type /my-skill in the Claude Code prompt

  3. Observe that the argument hint is not displayed in the autocomplete dropdown

  4. Now create a project-level skill at .claude/skills/my-skill/SKILL.md with the exact same frontmatter

  5. Type /my-skill in the Claude Code prompt

  6. Observe that the argument hint is displayed correctly

Expected Behavior

argument-hint should be displayed in the slash command autocomplete UI for both plugin skills and project-level skills, since both use the same SKILL.md format.

Actual Behavior

Skill locationargument-hint displayed
.claude/skills/ (project-level)✅ Yes
plugins/*/skills/ (plugin, via --plugin-dir)❌ No
plugins/*/skills/ (plugin, via marketplace)❌ No

Environment

  • Claude Code version: v2.1.101
  • OS: macOS (Darwin 23.6.0)
  • Shell: zsh

extent analysis

TL;DR

The issue can be fixed by ensuring that the plugin skills are properly registered and handled in the autocomplete UI, potentially by updating the plugin loading mechanism to correctly parse the argument-hint frontmatter.

Guidance

  • Verify that the argument-hint frontmatter is correctly parsed and stored when loading plugin skills, and that this information is passed to the autocomplete UI.
  • Check the differences in how project-level skills and plugin skills are loaded and registered, as the issue seems to be specific to plugin skills.
  • Investigate if there are any specific configuration options or flags that need to be set when loading plugins to enable the display of argument-hint in the autocomplete UI.
  • Consider adding logging or debugging statements to the plugin loading and autocomplete UI code to understand why the argument-hint is not being displayed for plugin skills.

Example

No specific code example can be provided without more information about the internal workings of the Claude Code plugin system and autocomplete UI.

Notes

The issue seems to be specific to the way plugin skills are handled, and more investigation is needed to determine the root cause. The fact that project-level skills work correctly suggests that the issue is not with the argument-hint frontmatter itself, but rather with how it is being parsed and displayed for plugin skills.

Recommendation

Apply a workaround by modifying the plugin loading mechanism to correctly parse and display the argument-hint frontmatter for plugin skills, as the root cause of the issue is likely related to the plugin system rather than a version-specific bug.

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…
#model compatibility#GPU setup#container setup#orchestration issue#cache issue

Still need to ship something?

×6

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

Back to top recommendations

TRENDING