From a070d87d85814b9408b8b5bb6e5d69cd27de67be Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:42:52 -0800 Subject: [PATCH 1/8] feat(methods): add slackbot.skills.create method example Adds an example that calls slackbot.skills.create with the arguments from its reference page, and lists it in the methods README. Co-Authored-By: Claude --- methods/README.md | 4 ++ .../slackbot/skills/SlackbotSkillsCreate.java | 39 +++++++++++++++++++ .../main/java/slackbot/skills/manifest.json | 23 +++++++++++ 3 files changed, 66 insertions(+) create mode 100644 methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java create mode 100644 methods/src/main/java/slackbot/skills/manifest.json diff --git a/methods/README.md b/methods/README.md index a60fc01..2f4491a 100644 --- a/methods/README.md +++ b/methods/README.md @@ -43,3 +43,7 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques - **[chat.postMessage](https://docs.slack.dev/reference/methods/chat.postmessage)**: Sends a message to a channel. [Implementation](./src/main/java/chat/ChatPostMessage.java). +### slackbot + +- **[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). + diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java new file mode 100644 index 0000000..86c79fe --- /dev/null +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java @@ -0,0 +1,39 @@ +package slackbot.skills; + +import com.slack.api.Slack; +import com.slack.api.methods.MethodsClient; +import com.slack.api.methods.SlackApiException; +import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest; +import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse; +import com.slack.api.model.slackbot.SkillMcpServer; +import java.io.IOException; +import java.util.Arrays; + +public class SlackbotSkillsCreate { + + public static void main(String[] args) throws IOException, SlackApiException { + // Read a token from an environment variable + String token = System.getenv("SLACK_TOKEN"); + + // Initialize + MethodsClient methods = Slack.getInstance().methods(token); + + // Call the slackbot.skills.create method + SlackbotSkillsCreateRequest request = SlackbotSkillsCreateRequest.builder() + .displayName("Daily priorities") + .instructions("# Purpose\nSuggest the three most important things to work on today.") + .description("Reviews information from Slack and your calendar to suggest priorities for the day.") + .category("productivity") + .examplePrompt("Run {skill} for today") + .mcpServers(Arrays.asList(SkillMcpServer.builder() + .serviceType("app") + .appId("A0123ABCD") + .serverId("Amcp0456EFGH") + .build())) + .build(); + SlackbotSkillsCreateResponse response = methods.slackbotSkillsCreate(request); + + // Inspect the response + System.out.println(response); + } +} diff --git a/methods/src/main/java/slackbot/skills/manifest.json b/methods/src/main/java/slackbot/skills/manifest.json new file mode 100644 index 0000000..5314b20 --- /dev/null +++ b/methods/src/main/java/slackbot/skills/manifest.json @@ -0,0 +1,23 @@ +{ + "display_information": { + "name": "Slack API Methods", + "description": "Example implementations to call \"slackbot.skills\" methods" + }, + "features": { + "bot_user": { + "display_name": "Slack API Methods", + "always_online": true + } + }, + "oauth_config": { + "scopes": { + "bot": ["skills:read", "skills:write"], + "user": ["skills:read", "skills:write"] + } + }, + "settings": { + "org_deploy_enabled": true, + "socket_mode_enabled": true, + "token_rotation_enabled": false + } +} From 2c07720b9fc2058ec261ab7eee318c09116e3ef7 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:42:57 -0800 Subject: [PATCH 2/8] feat(methods): add slackbot.skills.info method example Adds an example that calls slackbot.skills.info with the arguments from its reference page, and lists it in the methods README. Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/SlackbotSkillsInfo.java | 27 +++++++++++++++++++ 2 files changed, 28 insertions(+) create mode 100644 methods/src/main/java/slackbot/skills/SlackbotSkillsInfo.java diff --git a/methods/README.md b/methods/README.md index 2f4491a..aeb341a 100644 --- a/methods/README.md +++ b/methods/README.md @@ -46,4 +46,5 @@ $ mvn compile exec:java -Dexec.mainClass=chat.ChatPostMessage # Make the reques ### slackbot - **[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.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). diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsInfo.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsInfo.java new file mode 100644 index 0000000..b28bfe6 --- /dev/null +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsInfo.java @@ -0,0 +1,27 @@ +package slackbot.skills; + +import com.slack.api.Slack; +import com.slack.api.methods.MethodsClient; +import com.slack.api.methods.SlackApiException; +import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest; +import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsInfoResponse; +import java.io.IOException; + +public class SlackbotSkillsInfo { + + public static void main(String[] args) throws IOException, SlackApiException { + // Read a token from an environment variable + String token = System.getenv("SLACK_TOKEN"); + + // Initialize + MethodsClient methods = Slack.getInstance().methods(token); + + // Call the slackbot.skills.info method + SlackbotSkillsInfoRequest request = + SlackbotSkillsInfoRequest.builder().skillId("F0123ABCD").build(); + SlackbotSkillsInfoResponse response = methods.slackbotSkillsInfo(request); + + // Inspect the response + System.out.println(response); + } +} From 71d23ee18d19423bc1d6a75cba7b254a0e684464 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:43:02 -0800 Subject: [PATCH 3/8] feat(methods): add slackbot.skills.update method example Adds an example that calls slackbot.skills.update with the arguments from its reference page, and lists it in the methods README. Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/SlackbotSkillsUpdate.java | 40 +++++++++++++++++++ 2 files changed, 41 insertions(+) create mode 100644 methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java diff --git a/methods/README.md b/methods/README.md index aeb341a..a336d98 100644 --- a/methods/README.md +++ b/methods/README.md @@ -47,4 +47,5 @@ $ 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.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.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). diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java new file mode 100644 index 0000000..22bc3d0 --- /dev/null +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java @@ -0,0 +1,40 @@ +package slackbot.skills; + +import com.slack.api.Slack; +import com.slack.api.methods.MethodsClient; +import com.slack.api.methods.SlackApiException; +import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest; +import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse; +import com.slack.api.model.slackbot.SkillMcpServer; +import java.io.IOException; +import java.util.Arrays; + +public class SlackbotSkillsUpdate { + + public static void main(String[] args) throws IOException, SlackApiException { + // Read a token from an environment variable + String token = System.getenv("SLACK_TOKEN"); + + // Initialize + MethodsClient methods = Slack.getInstance().methods(token); + + // Call the slackbot.skills.update method + SlackbotSkillsUpdateRequest request = SlackbotSkillsUpdateRequest.builder() + .skillId("F0123ABCD") + .displayName("Daily priorities") + .instructions("# Purpose\nSuggest the three most important things to work on today.") + .description("Reviews information from Slack and your calendar to suggest priorities for the day.") + .category("productivity") + .examplePrompt("Run {skill} for today") + .mcpServers(Arrays.asList(SkillMcpServer.builder() + .serviceType("app") + .appId("A0123ABCD") + .serverId("Amcp0456EFGH") + .build())) + .build(); + SlackbotSkillsUpdateResponse response = methods.slackbotSkillsUpdate(request); + + // Inspect the response + System.out.println(response); + } +} From 5dba4f6167bea538e61ae351c5de3e2e05c6514f Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:43:07 -0800 Subject: [PATCH 4/8] feat(methods): add slackbot.skills.list method example Adds an example that calls slackbot.skills.list with the arguments from its reference page, and lists it in the methods README. Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/SlackbotSkillsList.java | 30 +++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 methods/src/main/java/slackbot/skills/SlackbotSkillsList.java diff --git a/methods/README.md b/methods/README.md index a336d98..4ccdaba 100644 --- a/methods/README.md +++ b/methods/README.md @@ -47,5 +47,6 @@ $ 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.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.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). diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java new file mode 100644 index 0000000..9a2dc25 --- /dev/null +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java @@ -0,0 +1,30 @@ +package slackbot.skills; + +import com.slack.api.Slack; +import com.slack.api.methods.MethodsClient; +import com.slack.api.methods.SlackApiException; +import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest; +import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsListResponse; +import java.io.IOException; + +public class SlackbotSkillsList { + + public static void main(String[] args) throws IOException, SlackApiException { + // Read a token from an environment variable + String token = System.getenv("SLACK_TOKEN"); + + // Initialize + MethodsClient methods = Slack.getInstance().methods(token); + + // Call the slackbot.skills.list method + SlackbotSkillsListRequest request = SlackbotSkillsListRequest.builder() + .filter("library") + .category("productivity") + .limit(100) + .build(); + SlackbotSkillsListResponse response = methods.slackbotSkillsList(request); + + // Inspect the response + System.out.println(response); + } +} From 3c276a5117fddf27d341c43d59e0015260feb5f1 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Thu, 12 Nov 2026 17:00:28 -0800 Subject: [PATCH 5/8] refactor(methods): use SlackbotSkillsCreateRequest.McpServer in the create example Co-Authored-By: Claude --- .../src/main/java/slackbot/skills/SlackbotSkillsCreate.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java index 86c79fe..ceb65d9 100644 --- a/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsCreate.java @@ -5,7 +5,6 @@ import com.slack.api.methods.SlackApiException; import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest; import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse; -import com.slack.api.model.slackbot.SkillMcpServer; import java.io.IOException; import java.util.Arrays; @@ -25,7 +24,7 @@ public static void main(String[] args) throws IOException, SlackApiException { .description("Reviews information from Slack and your calendar to suggest priorities for the day.") .category("productivity") .examplePrompt("Run {skill} for today") - .mcpServers(Arrays.asList(SkillMcpServer.builder() + .mcpServers(Arrays.asList(SlackbotSkillsCreateRequest.McpServer.builder() .serviceType("app") .appId("A0123ABCD") .serverId("Amcp0456EFGH") From 1e0f5a10be309616a0adfc6e2dbf45c329b0d702 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Thu, 12 Nov 2026 17:00:42 -0800 Subject: [PATCH 6/8] refactor(methods): use SlackbotSkillsUpdateRequest.McpServer in the update example Co-Authored-By: Claude --- .../src/main/java/slackbot/skills/SlackbotSkillsUpdate.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java index 22bc3d0..99e2bcc 100644 --- a/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsUpdate.java @@ -5,7 +5,6 @@ import com.slack.api.methods.SlackApiException; import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest; import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse; -import com.slack.api.model.slackbot.SkillMcpServer; import java.io.IOException; import java.util.Arrays; @@ -26,7 +25,7 @@ public static void main(String[] args) throws IOException, SlackApiException { .description("Reviews information from Slack and your calendar to suggest priorities for the day.") .category("productivity") .examplePrompt("Run {skill} for today") - .mcpServers(Arrays.asList(SkillMcpServer.builder() + .mcpServers(Arrays.asList(SlackbotSkillsUpdateRequest.McpServer.builder() .serviceType("app") .appId("A0123ABCD") .serverId("Amcp0456EFGH") From dc2fb2f16191f9220f71328d03f2eebbd719182c Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 02:26:04 -0800 Subject: [PATCH 7/8] build(deps): bump slack-api-client to 1.55.0 in /methods Co-Authored-By: Claude --- methods/pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/pom.xml b/methods/pom.xml index fe99527..a24dbbf 100644 --- a/methods/pom.xml +++ b/methods/pom.xml @@ -71,7 +71,7 @@ com.slack.api slack-api-client - 1.54.0 + 1.55.0 From 4069c2bc910fedb681fa84d95db058d212696b89 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 11:07:09 -0800 Subject: [PATCH 8/8] chore(methods): list owned skills in the slackbot.skills.list example Co-authored-by: Michael Brooks <21328+mwbrooks@users.noreply.github.com> Co-Authored-By: Claude --- methods/src/main/java/slackbot/skills/SlackbotSkillsList.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java b/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java index 9a2dc25..3b0d237 100644 --- a/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java +++ b/methods/src/main/java/slackbot/skills/SlackbotSkillsList.java @@ -18,9 +18,8 @@ public static void main(String[] args) throws IOException, SlackApiException { // Call the slackbot.skills.list method SlackbotSkillsListRequest request = SlackbotSkillsListRequest.builder() - .filter("library") + .filter("owned") .category("productivity") - .limit(100) .build(); SlackbotSkillsListResponse response = methods.slackbotSkillsList(request);