Skip to content

docs: recommend Claude Code installs with the slack@slack marketplace - #211

Merged
mwbrooks merged 12 commits into
mainfrom
mwbrooks-docs-lead-with-slack-marketplace
Nov 6, 2026
Merged

mwbrooks merged 12 commits into
mainfrom
mwbrooks-docs-lead-with-slack-marketplace

Conversation

@mwbrooks

@mwbrooks mwbrooks commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

Summary

This pull request lists our own slack marketplace first in the Claude Code install steps, for developers and coding agents. Updates on the official Claude marketplace are experiencing large delays (it still installs v1.4.1, while ours installs v1.7.0), so we recommend ours until that is resolved.

/plugin marketplace add slackapi/slack-skills-plugin
/plugin install slack@slack

The README and the docs.slack.dev page still show slack@claude-plugins-official as the second option, with that note, and add a short "Switching from the official Claude marketplace" section: uninstall the official copy, install slack@slack, then check claude plugin list. The agent setup prompt installs and updates slack@slack, and uninstalls the official copy first if claude plugin list shows it.

Testing

On Claude Code 2.1.311, in a throwaway CLAUDE_CONFIG_DIR:

  • Installing both slack@claude-plugins-official and slack@slack left both enabled (v1.4.1 and v1.7.0), which is why the docs say to install from one marketplace only.
  • claude plugin uninstall slack@claude-plugins-official left only slack@slack, and claude plugin list showed its marketplace, version, and status.
  • claude plugin marketplace update slack and claude plugin update slack@slack succeed without a GitHub SSH key since fix: update the Claude Code marketplace plugin over HTTPS #209.
  • make lint and make test-unit pass. test_install_commands_match_readme now maps claude plugin marketplace add to /plugin marketplace add.

Notes

  • This came from a developer question on X about switching from slack@claude-plugins-official to slack@slack: https://x.com/dustADD/status/2117820652652843352
  • Once the official marketplace gets releases on day one again, we can swap the order back.

Requirements

  • I've read and understood the Contributing Guidelines and have done my best effort to follow them.
  • I've read and agree to the Code of Conduct.
  • I've run make test and the tests pass. (Unit tests pass locally, and the eval tests pass in CI.)

@mwbrooks mwbrooks added docs Improvements or additions to documentation semver:patch Changes trigger a patch version bump area:claude Claude Code surface: .claude-plugin manifest, marketplace listing, and install paths area:agent-setup Agent setup prompt served at docs.slack.dev/agent-setup/prompt.md labels Nov 5, 2026
@mwbrooks mwbrooks self-assigned this Nov 5, 2026
@changeset-bot

changeset-bot Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 8f3fe91

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
slack Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@mwbrooks mwbrooks changed the title docs: lead Claude Code installs with the slack@slack marketplace docs: recommend Claude Code installs with the slack@slack marketplace Nov 6, 2026
@mwbrooks
mwbrooks marked this pull request as ready for review November 6, 2026 05:38
@mwbrooks
mwbrooks requested a review from a team as a code owner November 6, 2026 05:38

@zimeg zimeg left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📚 @mwbrooks LGTM! Leading with slack@slack while the official listing catches up makes sense, and the switching steps read clear.

🧹 quibble: The docs page's "Without auto-update" line might list claude plugin update slack@slack too, like the README does, since I think the marketplace update alone only refreshes the listing.

@mwbrooks

mwbrooks commented Nov 6, 2026

Copy link
Copy Markdown
Member Author

Thanks @zimeg and @WilliamBergamin for the reviews! 🙇 Applied Eden's update-command quibble in 8f3fe91.

@mwbrooks
mwbrooks merged commit 2a2b7ae into main Nov 6, 2026
7 checks passed
@mwbrooks
mwbrooks deleted the mwbrooks-docs-lead-with-slack-marketplace branch November 6, 2026 16:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:agent-setup Agent setup prompt served at docs.slack.dev/agent-setup/prompt.md area:claude Claude Code surface: .claude-plugin manifest, marketplace listing, and install paths docs Improvements or additions to documentation semver:patch Changes trigger a patch version bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants