Skip to content

Plugin skills not appearing in slash command autocomplete #21125

Description

@boshu2

Bug Report: Plugin skills not appearing in slash command autocomplete

Preflight Checklist

  • I have searched existing issues and this is not a duplicate
  • This is a single bug report (not multiple issues)
  • I am using the latest version of Claude Code

What's Wrong?

Skills from a marketplace plugin work when typed directly but don't appear in the / slash command autocomplete dropdown. Another plugin (superpowers) from a different marketplace shows its skills in autocomplete correctly. Both plugins have identical directory structure and SKILL.md format.

When typing /supe, autocomplete shows:

  • /superpowers:brainstorm
  • /superpowers:execute-plan
  • etc.

When typing /agent or /res or /vibe, autocomplete shows nothing from the agentops plugin.

However, typing /vibe directly and pressing Enter does work - the skill loads and executes correctly.


What Should Happen?

All skills from all enabled plugins should appear in the autocomplete dropdown when typing /. The agentops skills should appear alongside superpowers skills:

  • /agentops:research
  • /agentops:vibe
  • /agentops:plan
  • etc.

Steps to Reproduce

  1. Add a custom marketplace:

    claude plugin marketplace add agentops-marketplace https://github.com/boshu2/agentops
  2. Install the plugin:

    claude plugin install agentops@agentops-marketplace
  3. Verify installation:

    claude plugin list
    # Output shows: agentops@agentops-marketplace, Version: 1.0.8, Status: ✔ enabled
  4. Validate the plugin (passes):

    claude plugin validate ~/.claude/plugins/cache/agentops-marketplace/agentops/1.0.8
    # Output: ✔ Validation passed
  5. Start a new Claude Code session:

    claude
  6. Type / and observe the autocomplete dropdown - agentops skills are missing

  7. Type /vibe and press Enter - skill executes correctly (proving it IS loaded)


Is this a regression?

Yes, this is a regression. The agentops plugin skills were appearing correctly in autocomplete before. After an uninstall/reinstall cycle (to troubleshoot a different issue), they no longer appear in autocomplete even though the skills still work when typed directly.


Claude Code Version

2.1.19 (Claude Code)

Platform

Anthropic API (direct)


Operating System

macOS Darwin 25.2.0 (Sequoia)


Terminal/Shell

  • Terminal: iTerm2
  • Shell: zsh

Additional Context

Evidence that skills ARE loaded correctly

The plugin's skills appear in Claude's Skill tool context and execute when typed directly:

> /vibe
[Skill loads, SKILL.md content displayed, workflow executes successfully]

Plugin structure comparison

Both plugins have identical structure:

.claude-plugin/
├── plugin.json
└── marketplace.json
skills/
├── skillname/
│   └── SKILL.md
└── ...

SKILL.md format is identical

Both use the same YAML frontmatter:

---
name: skillname
description: "Skill description"
---
# Skill content...

Troubleshooting attempted

  1. Uninstall plugin → reinstall: No change
  2. Clear plugin cache → reinstall: No change
  3. Update marketplace → reinstall: No change
  4. Start new session: No change
  5. Validate plugin: Passes

Hypothesis

The autocomplete dropdown may use a separate cache that isn't refreshed when plugins are installed, or there's a race condition where recently installed plugins aren't registered for autocomplete even though they load correctly at runtime.


Workaround

Type skill commands directly (e.g., /vibe, /research) - they execute correctly despite not appearing in autocomplete.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:tuibugSomething isn't workinghas reproHas detailed reproduction stepsplatform:macosIssue specifically occurs on macOS

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions