Plugin slash commands render with '*'-inline format instead of two-column, despite matching official plugin shape
Summary
Plugin commands in egor-xyz/agent-kit consistently render in the slash menu with the *-inline format (* /agent-kit:handoff - (agent-kit) Dump session state...) instead of the two-column format used by official plugins like commit-commands. The plugin viewer (/plugin → Installed) correctly classifies them as Commands, but the slash menu treats them like skills.
Repro
/plugin marketplace add egor-xyz/agent-kit
/plugin install agent-kit@egor-xyz
Then type /han in the slash menu and compare against /commit (commit-commands from claude-plugins-official).
commit-commands:commit-push-pr→ two-column ✓agent-kit:handoff→*-inline ✗
Both are installed via marketplace, both live under commands/*.md, both have matched frontmatter shape (allowed-tools: + description:), both have similar plugin.json shape.
What we ruled out across 6 PRs
| PR | Hypothesis | Result |
|----|-----------|--------|
| #16 | Files were under skills/ (correct fix: move to commands/) | Fixed namespace prefix but * persists |
| #17 | Frontmatter order, description length, allowed-tools scoping | No effect |
| #18 | Marketplace metadata fields (tags/keywords/license), \$schema URL | No effect |
| #19 | Coexistence with skills/ directory in same plugin | No effect |
| #21 | H1 vs H2 first body heading | No effect |
After PR #21 the plugin's file shape is byte-identical in structure to commit-commands:
commands/handoff.mdfrontmatter:allowed-tools: Bash, Read, Write, Edit\ndescription: Dump session state to .agents/handoff.md(matches commit-commands shape exactly)plugin.json:{name, description, author}onlymarketplace.json:{\$schema: anthropic.com/.../marketplace.schema.json, name, description, owner, plugins:[{name, description, author, source, category, homepage}]}(matchesclaude-plugins-officialexactly)
Yet the rendering disagrees.
Plugin viewer (correct)
agent-kit @ egor-xyz
Installed components:
• Commands: handoff-clear, handoff-resume, handoff
• Skills: auto-handoff
So internal classification is right. The slash menu disagrees.
Ask
Either:
- Document what specific field/structure determines two-column vs \
*\-inline rendering in the slash menu, so 3rd-party plugins can match it, or - Treat this as a bug — \
commands/*.md\files should always render two-column.
Repo for reference: https://github.com/egor-xyz/agent-kit
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗