claude-code - 💡(How to fix) Fix 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

After PR #21 the plugin's file shape is byte-identical in structure to commit-commands:

• commands/handoff.md frontmatter: allowed-tools: Bash, Read, Write, Edit\ndescription: Dump session state to .agents/handoff.md (matches commit-commands shape exactly)
• plugin.json: {name, description, author} only
• marketplace.json: {\$schema: anthropic.com/.../marketplace.schema.json, name, description, owner, plugins:[{name, description, author, source, category, homepage}]} (matches claude-plugins-official exactly)

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:

1. Document what specific field/structure determines two-column vs `*`-inline rendering in the slash menu, so 3rd-party plugins can match it, or
2. Treat this as a bug — `commands/*.md` files should always render two-column.

Repo for reference: https://github.com/egor-xyz/agent-kit