From e7714b05b67563ab9020c2915c6f71bbb405775a Mon Sep 17 00:00:00 2001
From: William Bergamin <wbergamin@slack-corp.com>
Date: Wed, 22 Jul 2026 11:45:14 -0400
Subject: [PATCH] docs: align Claude Code and Cursor plugin manifest metadata

Bring the .claude-plugin and .cursor-plugin manifests in line with the
Codex surface cleanup:

- Refresh the generic .claude-plugin description to describe the plugin's
  actual MCP server + skills.
- Add a repository field to both manifests (source-code URL) and point
  homepage at the docs.slack.dev developer hub.
- Add the JSON Schema reference to the Claude Code manifest for editor
  autocomplete and validation.
- Give the Cursor manifest an author.url for consistency.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
---
 .changeset/align-plugin-manifest-metadata.md | 5 +++++
 .claude-plugin/plugin.json                   | 6 ++++--
 .cursor-plugin/plugin.json                   | 5 ++++-
 3 files changed, 13 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/align-plugin-manifest-metadata.md

diff --git a/.changeset/align-plugin-manifest-metadata.md b/.changeset/align-plugin-manifest-metadata.md
new file mode 100644
index 0000000..3471d2a
--- /dev/null
+++ b/.changeset/align-plugin-manifest-metadata.md
@@ -0,0 +1,5 @@
+---
+"slack": patch
+---
+
+Align the install-surface metadata across the Claude Code and Cursor plugin manifests. Refresh the `.claude-plugin/plugin.json` description, add a `repository` field to both manifests, point `homepage` at the `docs.slack.dev` developer hub, and add the JSON Schema reference to the Claude Code manifest for editor validation.
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 7fa03b6..b70c2be 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,11 +1,13 @@
 {
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "slack",
-  "description": "Slack integration for searching messages, sending communications, managing canvases, and more",
+  "description": "Bring Slack into your AI tools with a Slack MCP server and Slack skills",
   "version": "1.1.0",
   "author": {
     "name": "Slack",
     "url": "https://slack.com"
   },
-  "homepage": "https://github.com/slackapi/slack-skills-plugin",
+  "homepage": "https://docs.slack.dev",
+  "repository": "https://github.com/slackapi/slack-skills-plugin",
   "license": "MIT"
 }
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index d11ebcd..0d42b8a 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -4,7 +4,10 @@
   "version": "1.1.0",
   "mcpServers": "../.cursor-mcp.json",
   "author": {
-    "name": "Slack"
+    "name": "Slack",
+    "url": "https://slack.com"
   },
+  "homepage": "https://docs.slack.dev",
+  "repository": "https://github.com/slackapi/slack-skills-plugin",
   "skills": "./skills/"
 }