Repository navigation
feat: add official Slack plugin (slackapi/slack-skills-plugin) to the marketplace - #303
Conversation
… 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.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Up to standards ✅🟢 Issues
|
There was a problem hiding this comment.
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.
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
2 issues found across 2 files
Confidence score: 4/5
README.mdlists 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.jsonis missingfilesReadpatterns forslack.jsonand.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
Reply with feedback, questions, or to request a fix.
Turn on auto-fix | Re-trigger cubic
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.
|
/gemini review |
There was a problem hiding this comment.
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.
|
[Medium impact] The PR appears safe to merge; no actionable issues were found. SummaryAdds the official Slack plugin as an external source without vendoring plugin code.
Reviews (1) · Last reviewed commit: "chore(slack): apply review suggestions t..." · Reviewed by Greptile |



Summary
Lists the official Slack plugin (
slack, slackapi/slack-skills-plugin, v1.6.0, MIT, owned by theslackapiorg) 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 agithubsource, listed the same way asdart-flutter,grafana, andfirecrawl.relevanceblock: clislack; hostsslack.com,api.slack.com,docs.slack.dev; manifestDeps@slack/bolt|@slack/web-apiinpackage.jsonandslack-bolt/slack-sdkinrequirements*.txt/pyproject.toml.README.md: Slack entry under External Plugins and the install line.Scope
External entry only.
multi-formatand the release-please files are not touched, because they apply only to local./plugins/...sources.Tradeoffs
plugins/slack, as fix(claude-code-docs): vendor plugin into the marketplace #297 and fix(modern-web-guidance): vendor plugin into the marketplace #299 did for other plugins, was not taken: upstream is owned byslackapi, and agithubsource keeps updates upstream-driven.slackCLI and@slack/boltsignals overlap with the existingslack-agentplugin, so both may be suggested to the same user.Blast radius
Marketplace metadata and README only. No local plugin code changes.
Verification
claude plugin validate .claude-plugin/marketplace.jsonreports 2 errors that already exist on main (reserved namesclaude-md-management,claude-code-docs). The new entry adds no errors or warnings.Checklist
bun run test): not applicable, no code changesbun run lint): not applicable, metadata and docs onlySummary 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.slackentry to both.claude-plugin/marketplace.jsonand the Codex marketplace.agents/plugins/marketplace.jsonwith relevance signals for theslackCLI, Slack hosts (slack.com,api.slack.com,docs.slack.dev),@slack/bolt/@slack/web-apidependencies, and Slack CLI project directories (.slack/).multi-format, or release-please changes.slackCLI and@slack/boltsignals overlap with the existingslack-agentplugin, so both may be suggested for the same project.Written for commit 91a80b7. Summary will update on new commits.