Plugin slash commands render with '*'-inline format instead of two-column, despite matching official plugin shape

Resolved 💬 1 comment Opened May 28, 2026 by egor-xyz Closed Jun 29, 2026

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.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

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗