[BUG] argument-hint frontmatter not displayed for plugin skills in slash command autocomplete
Resolved 💬 4 comments Opened Apr 11, 2026 by sieg-zeon Closed May 24, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] 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
- Create a plugin with a skill that has
argument-hintin frontmatter:
---
name: my-skill
description: "My skill description"
argument-hint: "<arg1> [--option]"
---
- Load the plugin via
--plugin-dir ./plugins/my-pluginor install from a marketplace - Type
/my-skillin the Claude Code prompt - Observe that the argument hint is not displayed in the autocomplete dropdown
- Now create a project-level skill at
.claude/skills/my-skill/SKILL.mdwith the exact same frontmatter - Type
/my-skillin the Claude Code prompt - 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 location | argument-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
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗