From 86cfa43935d9a0cb259ba212035db1afaff66fcf Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 11:51:02 -0800 Subject: [PATCH 1/5] fix(methods): match docs summaries and disable socket mode for slackbot.skills examples Co-Authored-By: Claude --- methods/README.md | 8 ++++---- methods/src/main/java/admin/slackbot/skills/manifest.json | 2 +- .../src/main/java/slackbot/skills/library/manifest.json | 2 +- methods/src/main/java/slackbot/skills/manifest.json | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/methods/README.md b/methods/README.md index 116b52a..be0f7b5 100644 --- a/methods/README.md +++ b/methods/README.md @@ -18,7 +18,7 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques ### admin -- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java). +- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for Slackbot skills owned by an organization. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsPublish.java). - **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsSetAutoEnabled.java). - **[admin.slackbot.skills.unpublish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.unpublish)**: Removes Slackbot skills from the org catalog, preserving access, libraries, and deployments. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsUnpublish.java). @@ -55,8 +55,8 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsCreate.java). - **[slackbot.skills.delete](https://docs.slack.dev/reference/methods/slackbot.skills.delete)**: Deletes a Slackbot skill and its canvas, and removes it from every library, skill set, and the org catalog. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsDelete.java). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsInfo.java). -- **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's personal library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryAdd.java). -- **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's personal library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryRemove.java). +- **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's Slackbot library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryAdd.java). +- **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's Slackbot library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryRemove.java). - **[slackbot.skills.list](https://docs.slack.dev/reference/methods/slackbot.skills.list)**: Lists Slackbot skills from the caller's point of view. Instructions are not included. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsList.java). -- **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsUpdate.java). +- **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsUpdate.java). diff --git a/methods/src/main/java/admin/slackbot/skills/manifest.json b/methods/src/main/java/admin/slackbot/skills/manifest.json index 524e42e..a3f98a8 100644 --- a/methods/src/main/java/admin/slackbot/skills/manifest.json +++ b/methods/src/main/java/admin/slackbot/skills/manifest.json @@ -10,7 +10,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } diff --git a/methods/src/main/java/slackbot/skills/library/manifest.json b/methods/src/main/java/slackbot/skills/library/manifest.json index f22a91c..20367aa 100644 --- a/methods/src/main/java/slackbot/skills/library/manifest.json +++ b/methods/src/main/java/slackbot/skills/library/manifest.json @@ -17,7 +17,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } diff --git a/methods/src/main/java/slackbot/skills/manifest.json b/methods/src/main/java/slackbot/skills/manifest.json index 5314b20..ba5a961 100644 --- a/methods/src/main/java/slackbot/skills/manifest.json +++ b/methods/src/main/java/slackbot/skills/manifest.json @@ -17,7 +17,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } From 2ed484c8bfd669a2e4143911b8f8768870dee9aa Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 12:43:13 -0800 Subject: [PATCH 2/5] chore(methods): drop the default limit from the admin.slackbot.skills.list example Co-Authored-By: Claude --- .../main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java | 1 - 1 file changed, 1 deletion(-) diff --git a/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java b/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java index a736a1b..cf733cc 100644 --- a/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java +++ b/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java @@ -20,7 +20,6 @@ public static void main(String[] args) throws IOException, SlackApiException { // Call the admin.slackbot.skills.list method AdminSlackbotSkillsListRequest request = AdminSlackbotSkillsListRequest.builder() .category("productivity") - .limit(100) .creatorIds(Arrays.asList("U0123ABCD")) .publishStatus("all") .autoEnabledStatus("all") From 89cd37474ea1b18d3b2bb84262e5b37d0337dfbc Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 15:06:20 -0800 Subject: [PATCH 3/5] chore(methods): drop default arguments from the admin.slackbot.skills.list example Co-Authored-By: Claude --- .../java/admin/slackbot/skills/AdminSlackbotSkillsList.java | 4 ---- 1 file changed, 4 deletions(-) diff --git a/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java b/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java index cf733cc..3fb1eb8 100644 --- a/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java +++ b/methods/src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java @@ -21,10 +21,6 @@ public static void main(String[] args) throws IOException, SlackApiException { AdminSlackbotSkillsListRequest request = AdminSlackbotSkillsListRequest.builder() .category("productivity") .creatorIds(Arrays.asList("U0123ABCD")) - .publishStatus("all") - .autoEnabledStatus("all") - .sort("name") - .sortDir("asc") .build(); AdminSlackbotSkillsListResponse response = methods.adminSlackbotSkillsList(request); From bdb22b7726889ae733c11d8bf2addf64080ae551 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 15:38:11 -0800 Subject: [PATCH 4/5] fix(methods): keep docs descriptions in the methods README to match other examples Co-Authored-By: Claude --- methods/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/methods/README.md b/methods/README.md index b4fd636..f4186f9 100644 --- a/methods/README.md +++ b/methods/README.md @@ -21,7 +21,7 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques - **[admin.apps.mcp.servers.list](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.list)**: List third-party app MCP servers approved for an organization. [Implementation](./src/main/java/admin/apps/mcp/servers/AdminAppsMcpServersList.java). - **[admin.apps.mcp.servers.permissions.list](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.permissions.list)**: List MCP servers for an app with their access control permissions. [Implementation](./src/main/java/admin/apps/mcp/servers/permissions/AdminAppsMcpServersPermissionsList.java). - **[admin.apps.mcp.servers.permissions.set](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.permissions.set)**: Set the access control permission for who can use an MCP server. [Implementation](./src/main/java/admin/apps/mcp/servers/permissions/AdminAppsMcpServersPermissionsSet.java). -- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for Slackbot skills owned by an organization. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java). +- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsList.java). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsPublish.java). - **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsSetAutoEnabled.java). - **[admin.slackbot.skills.unpublish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.unpublish)**: Removes Slackbot skills from the org catalog, preserving access, libraries, and deployments. [Implementation](./src/main/java/admin/slackbot/skills/AdminSlackbotSkillsUnpublish.java). @@ -58,8 +58,8 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsCreate.java). - **[slackbot.skills.delete](https://docs.slack.dev/reference/methods/slackbot.skills.delete)**: Deletes a Slackbot skill and its canvas, and removes it from every library, skill set, and the org catalog. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsDelete.java). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsInfo.java). -- **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's Slackbot library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryAdd.java). -- **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's Slackbot library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryRemove.java). +- **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's personal library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryAdd.java). +- **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's personal library. [Implementation](./src/main/java/slackbot/skills/library/SlackbotSkillsLibraryRemove.java). - **[slackbot.skills.list](https://docs.slack.dev/reference/methods/slackbot.skills.list)**: Lists Slackbot skills from the caller's point of view. Instructions are not included. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsList.java). -- **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsUpdate.java). +- **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/main/java/slackbot/skills/SlackbotSkillsUpdate.java). From 23dd3393e63366362e9f03d1dfcd23003407cb2f Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 16:16:52 -0800 Subject: [PATCH 5/5] fix(methods): request bot scopes only for the slackbot.skills examples Co-Authored-By: Claude --- methods/src/main/java/slackbot/skills/library/manifest.json | 3 +-- methods/src/main/java/slackbot/skills/manifest.json | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/methods/src/main/java/slackbot/skills/library/manifest.json b/methods/src/main/java/slackbot/skills/library/manifest.json index 20367aa..91a613c 100644 --- a/methods/src/main/java/slackbot/skills/library/manifest.json +++ b/methods/src/main/java/slackbot/skills/library/manifest.json @@ -11,8 +11,7 @@ }, "oauth_config": { "scopes": { - "bot": ["skills:write"], - "user": ["skills:write"] + "bot": ["skills:write"] } }, "settings": { diff --git a/methods/src/main/java/slackbot/skills/manifest.json b/methods/src/main/java/slackbot/skills/manifest.json index ba5a961..37acb81 100644 --- a/methods/src/main/java/slackbot/skills/manifest.json +++ b/methods/src/main/java/slackbot/skills/manifest.json @@ -11,8 +11,7 @@ }, "oauth_config": { "scopes": { - "bot": ["skills:read", "skills:write"], - "user": ["skills:read", "skills:write"] + "bot": ["skills:read", "skills:write"] } }, "settings": {