Skip to content

feat: add official Slack plugin (slackapi/slack-skills-plugin) to the marketplace - #303

Merged
amondnet merged 2 commits into
mainfrom
amondnet/slack
Nov 2, 2026
Merged

amondnet merged 2 commits into
mainfrom
amondnet/slack

Conversation

@amondnet

@amondnet amondnet commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Lists the official Slack plugin (slack, slackapi/slack-skills-plugin, v1.6.0, MIT, owned by the slackapi org) in the marketplace. Claude Code installs it from upstream, so nothing is vendored here. The plugin ships the hosted Slack MCP server (https://mcp.slack.com/mcp, OAuth), slash commands, and developer skills (block-kit, slack-api, slack-cli, slack-docs, slack-messaging, slack-search, create-/test-/deploy-slack-app).

What changed

  • .claude-plugin/marketplace.json: new external entry with a github source, listed the same way as dart-flutter, grafana, and firecrawl.
  • relevance block: cli slack; hosts slack.com, api.slack.com, docs.slack.dev; manifestDeps @slack/bolt|@slack/web-api in package.json and slack-bolt/slack-sdk in requirements*.txt / pyproject.toml.
  • README.md: Slack entry under External Plugins and the install line.

Scope

External entry only. multi-format and the release-please files are not touched, because they apply only to local ./plugins/... sources.

Tradeoffs

Blast radius

Marketplace metadata and README only. No local plugin code changes.

Verification

  • claude plugin validate .claude-plugin/marketplace.json reports 2 errors that already exist on main (reserved names claude-md-management, claude-code-docs). The new entry adds no errors or warnings.

Checklist

  • PR title follows Conventional Commits
  • Tests added or updated, and the suite passes (bun run test): not applicable, no code changes
  • Lint/format pass (bun run lint): not applicable, metadata and docs only
  • Documentation updated if behavior changed
  • No breaking change

Summary by cubic

Lists the official Slack plugin (slackapi/slack-skills-plugin) in the marketplace as an external github-source entry, so Claude Code installs it from upstream instead of vendoring it here.

  • Adds a slack entry to both .claude-plugin/marketplace.json and the Codex marketplace .agents/plugins/marketplace.json with relevance signals for the slack CLI, Slack hosts (slack.com, api.slack.com, docs.slack.dev), @slack/bolt / @slack/web-api dependencies, and Slack CLI project directories (.slack/).
  • Adds the plugin to the README's External Plugins section and the install list.
  • Touches marketplace metadata and README only; no local plugin code, multi-format, or release-please changes.
  • The slack CLI and @slack/bolt signals overlap with the existing slack-agent plugin, so both may be suggested for the same project.

Written for commit 91a80b7. Summary will update on new commits.

Turn on auto-fix

… marketplace

Register the official Slack plugin as an external github-source entry
named `slack` in the Claude Code marketplace, with category, keywords,
tags, homepage, and a relevance block (cli `slack`; hosts slack.com,
api.slack.com, docs.slack.dev; manifestDeps for @slack/bolt and
@slack/web-api in package.json and slack-bolt and slack-sdk in
requirements*.txt and pyproject.toml).

Add a Slack entry under External Plugins in the README and
`/plugin install slack@pleaseai` to the install list. The plugin is an
external source, so no multi-format artifacts are generated.
@vercel

vercel Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
claude-code-plugins Ready Ready Preview Nov 2, 2026 6:48am UTC

Request Review

@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request registers the official Slack plugin in the marketplace configuration (.claude-plugin/marketplace.json) and updates the README.md with its installation instructions and documentation. The review feedback recommends improving the plugin's discoverability by adding filesRead relevance signals to detect Slack CLI configuration files and directories, ensuring automatic suggestions for developers working on Slack CLI-based applications.

Comment thread .claude-plugin/marketplace.json Resolved
@amondnet
amondnet marked this pull request as ready for review November 2, 2026 06:42
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-02T06:44:32.129815Z 6b78694 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

2 issues found across 2 files

Confidence score: 4/5

  • README.md lists the Slack command as available across all three runtimes, but it is missing from the generated Codex marketplace and Antigravity plugin directory. Update the runtime listing so it matches what is actually generated.
  • .claude-plugin/marketplace.json is missing filesRead patterns for slack.json and .slack, so Slack CLI projects may not trigger the plugin’s relevance signal. Add those patterns.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. When an issue isn't valid or won't be fixed in this PR, reply in its thread with the reason and then resolve the thread. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="README.md">

<violation number="1" location="README.md:616">
P2: This command is listed as available across all three runtimes, but Slack is a GitHub-sourced entry and is omitted from the generated Codex marketplace; Antigravity likewise has no generated plugin directory. Remove it from this cross-runtime command block, or document a separate Claude-only installation path.</violation>
</file>

<file name=".claude-plugin/marketplace.json">

<violation number="1" location=".claude-plugin/marketplace.json:1796">
P2: Add `filesRead` patterns for `slack.json` and `.slack` so Slack CLI projects can trigger the plugin’s relevance signal.</violation>
</file>
Architecture diagram
sequenceDiagram
    participant Dev as Developer
    participant CC as Claude Code
    participant MP as Marketplace (github.com/pleaseai/claude-code-plugins)
    participant GH as GitHub (slackapi/slack-skills-plugin)
    participant SlackMCP as Slack Hosted MCP (mcp.slack.com/mcp)
    participant SlackWS as Slack Workspace API
    participant Skills as Bundled Developer Skills

    Note over Dev,Skills: PR Adds "slack" Entry to External Marketplace

    Dev->>CC: /plugin install slack@pleaseai
    CC->>MP: Query marketplace.json for "slack" entry
    MP-->>CC: Entry with github source

    CC->>CC: Recognize external github source
    CC->>GH: Fetch plugin (slackapi/slack-skills-plugin v1.6.0)

    alt Source found on GitHub
        GH-->>CC: Plugin metadata + skills
        CC->>CC: Load plugin locally (skills, slash commands)
    else Source unavailable
        CC-->>Dev: Error: plugin not installed
    end

    Note over CC,SlackWS: Runtime - OAuth Flow

    Dev->>CC: Interact with Slack workspace (search/read/send)
    CC->>SlackMCP: Request OAuth authorization (scopes)
    SlackMCP-->>Dev: OAuth consent prompt
    Dev-->>SlackMCP: Approve (token)
    SlackMCP-->>CC: Access token

    CC->>SlackMCP: MCP request (with token)
    SlackMCP->>SlackWS: Call Slack API (conversations, messages, canvases)
    SlackWS-->>SlackMCP: Response data
    SlackMCP-->>CC: Formatted result
    CC-->>Dev: Display result

    Note over CC,Skills: Developer Skills Flow

    Dev->>CC: Invoke skill (block-kit, slack-api, slack-cli, etc.)
    CC->>Skills: Run skill logic (local)
    Skills->>SlackWS: API/CLI operations (if needed)
    SlackWS-->>Skills: Result
    Skills-->>CC: Formatted output
    CC-->>Dev: Render skill result

    Note over CC,MP: Relevance Matching (for auto-suggestion)

    CC->>CC: Scan project files
    alt Detect slack CLI / @slack/bolt in package.json OR slack-sdk in requirements
        CC->>MP: Query marketplace for matching plugins
        MP-->>CC: Returns "slack" (and possibly "slack-agent")
        CC-->>Dev: Suggest /plugin install slack@pleaseai
    end
Loading

Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic

Comment thread README.md Resolved
Comment thread .claude-plugin/marketplace.json Resolved
Add a filesRead relevance signal for the Slack CLI project directory
(.slack/, e.g. .slack/hooks.json) and regenerate the Codex marketplace so
the slack entry is installable there too.
@amondnet

amondnet commented Nov 2, 2026

Copy link
Copy Markdown
Contributor Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request integrates the official Slack plugin into the marketplace manifests and updates the README with installation instructions. The review feedback points out that .agents/plugins/marketplace.json is an auto-generated file and should not be edited manually; instead, the bun run plugins:multi-format script should be used. Additionally, it is recommended to add **/slack.json to the filesRead relevance signals in .claude-plugin/marketplace.json to reliably detect Slack CLI projects.

Comment thread .agents/plugins/marketplace.json Resolved
Comment thread .claude-plugin/marketplace.json Resolved
@sonarqubecloud

sonarqubecloud Bot commented Nov 2, 2026

Copy link
Copy Markdown

@amondnet
amondnet merged commit a78a6f0 into main Nov 2, 2026
12 checks passed
@amondnet
amondnet deleted the amondnet/slack branch November 2, 2026 07:34
@greptile-apps

greptile-apps Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

RetriggerView in GreptileConfidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable issues were found.

Summary

Adds the official Slack plugin as an external source without vendoring plugin code.

  • The marketplaces now offer Slack’s official plugin for Claude Code and Codex.

Reviews (1) · Last reviewed commit: "chore(slack): apply review suggestions t..." · Reviewed by Greptile

This branch was successfully deployed

1 active deployment
Preview — 91a80b7c Deployed Nov 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant