From 2e490ce6142d66623d09f42b980d0abec6a00d68 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:23:24 -0800 Subject: [PATCH 1/3] feat: add slackbot.skills.create method Co-Authored-By: Claude --- .changeset/slackbot-skills-create.md | 5 ++ packages/web-api/src/methods.ts | 12 ++++ packages/web-api/src/types/request/index.ts | 1 + .../web-api/src/types/request/slackbot.ts | 42 +++++++++++ .../response/SlackbotSkillsCreateResponse.ts | 54 ++++++++++++++ packages/web-api/src/types/response/index.ts | 1 + .../test/types/methods/slackbot.test-d.ts | 70 +++++++++++++++++++ 7 files changed, 185 insertions(+) create mode 100644 .changeset/slackbot-skills-create.md create mode 100644 packages/web-api/src/types/request/slackbot.ts create mode 100644 packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts create mode 100644 packages/web-api/test/types/methods/slackbot.test-d.ts diff --git a/.changeset/slackbot-skills-create.md b/.changeset/slackbot-skills-create.md new file mode 100644 index 000000000..10b4f9647 --- /dev/null +++ b/.changeset/slackbot-skills-create.md @@ -0,0 +1,5 @@ +--- +"@slack/web-api": minor +--- + +feat(web-api): add [`slackbot.skills.create`](https://docs.slack.dev/reference/methods/slackbot.skills.create) method diff --git a/packages/web-api/src/methods.ts b/packages/web-api/src/methods.ts index 640249ff2..73a38ebfe 100644 --- a/packages/web-api/src/methods.ts +++ b/packages/web-api/src/methods.ts @@ -234,6 +234,7 @@ import type { SearchAllArguments, SearchFilesArguments, SearchMessagesArguments, + SlackbotSkillsCreateArguments, SlackListsAccessDeleteArguments, SlackListsAccessSetArguments, SlackListsCreateArguments, @@ -518,6 +519,7 @@ import type { SearchAllResponse, SearchFilesResponse, SearchMessagesResponse, + SlackbotSkillsCreateResponse, SlackListsAccessDeleteResponse, SlackListsAccessSetResponse, SlackListsCreateResponse, @@ -2350,6 +2352,16 @@ export abstract class Methods extends EventEmitter { messages: bindApiCall(this, 'search.messages'), }; + public readonly slackbot = { + skills: { + /** + * @description Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. + * @see {@link https://docs.slack.dev/reference/methods/slackbot.skills.create `slackbot.skills.create` API reference}. + */ + create: bindApiCall(this, 'slackbot.skills.create'), + }, + }; + public readonly slackLists = { access: { /** diff --git a/packages/web-api/src/types/request/index.ts b/packages/web-api/src/types/request/index.ts index f38ebbf54..dc2253690 100644 --- a/packages/web-api/src/types/request/index.ts +++ b/packages/web-api/src/types/request/index.ts @@ -291,6 +291,7 @@ export type { SearchFilesArguments, SearchMessagesArguments, } from './search'; +export type { SlackbotSkillsCreateArguments } from './slackbot'; export type { SlackListsAccessDeleteArguments, SlackListsAccessSetArguments, diff --git a/packages/web-api/src/types/request/slackbot.ts b/packages/web-api/src/types/request/slackbot.ts new file mode 100644 index 000000000..c671707fb --- /dev/null +++ b/packages/web-api/src/types/request/slackbot.ts @@ -0,0 +1,42 @@ +import type { TokenOverridable } from './common'; + +// https://docs.slack.dev/reference/methods/slackbot.skills.create +export type SlackbotSkillsCreateArguments = TokenOverridable & { + /** @description Human-readable label. Max 255 characters; not unique. */ + display_name: string; +} & ( + | { + /** @description Markdown body of the skill. Send exactly one of `instructions` or `canvas_id`. */ + instructions: string; + canvas_id?: never; + } + | { + instructions?: never; + /** @description Canvas the caller owns to turn into a skill. Send exactly one of `instructions` or `canvas_id`. */ + canvas_id: string; + } + ) & { + /** @description When Slackbot should use the skill. Max 400 characters. */ + description?: string; + /** @description One of the skill categories. */ + category?: + | 'communication' + | 'customer_support' + | 'data_and_analytics' + | 'engineering' + | 'other' + | 'product_management' + | 'productivity' + | 'professional_development' + | 'project_management' + | 'sales' + | 'system' + | 'team_management'; + /** @description Max 200 characters. May contain `{skill}`, which becomes the skill mention. */ + example_prompt?: string; + /** + * @description Apps the skill needs, capped at the caller's MCP server limit. Declaring an app doesn't grant + * access to it. + */ + mcp_servers?: { service_type: string; app_id?: string; server_id?: string }[]; + }; diff --git a/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts b/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts new file mode 100644 index 000000000..09a6e94c8 --- /dev/null +++ b/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts @@ -0,0 +1,54 @@ +///////////////////////////////////////////////////////////////////////////////////////// +// // +// !!! DO NOT EDIT THIS FILE !!! // +// // +// This file is auto-generated by scripts/generate-web-api-types.sh in the repository. // +// Please refer to the script code to learn how to update the source data. // +// // +///////////////////////////////////////////////////////////////////////////////////////// + +import type { WebAPICallResult } from '../../WebClient'; +export type SlackbotSkillsCreateResponse = WebAPICallResult & { + error?: string; + invalid_mcp_servers?: InvalidmcpServer[]; + needed?: string; + ok?: boolean; + provided?: string; + skill?: Skill; + warning?: string; +}; + +export interface InvalidmcpServer { + app_id?: string; + server_id?: string; + service_type?: string; +} + +export interface Skill { + access?: string; + category?: string; + creator_id?: string; + date_created?: number; + date_updated?: number; + description?: string; + display_name?: string; + example_prompt?: string; + id?: string; + instructions?: string; + is_official?: boolean; + library_count?: number; + mcp_servers?: McpServer[]; + name?: string; + permalink?: string; + type?: string; + usage_count?: number; + visibility?: string; +} + +export interface McpServer { + app_id?: string; + display_name?: string; + is_available?: boolean; + server_id?: string; + service_type?: string; +} diff --git a/packages/web-api/src/types/response/index.ts b/packages/web-api/src/types/response/index.ts index fe0e41999..791c9b66d 100644 --- a/packages/web-api/src/types/response/index.ts +++ b/packages/web-api/src/types/response/index.ts @@ -292,6 +292,7 @@ export { RtmStartResponse } from './RtmStartResponse'; export { SearchAllResponse } from './SearchAllResponse'; export { SearchFilesResponse } from './SearchFilesResponse'; export { SearchMessagesResponse } from './SearchMessagesResponse'; +export { SlackbotSkillsCreateResponse } from './SlackbotSkillsCreateResponse'; export { SlackListsAccessDeleteResponse } from './SlackListsAccessDeleteResponse'; export { SlackListsAccessSetResponse } from './SlackListsAccessSetResponse'; export { SlackListsCreateResponse } from './SlackListsCreateResponse'; diff --git a/packages/web-api/test/types/methods/slackbot.test-d.ts b/packages/web-api/test/types/methods/slackbot.test-d.ts new file mode 100644 index 000000000..f41cee435 --- /dev/null +++ b/packages/web-api/test/types/methods/slackbot.test-d.ts @@ -0,0 +1,70 @@ +import { expectAssignable, expectError } from 'tsd'; +import { WebClient } from '../../../src/WebClient'; + +const web = new WebClient('TOKEN'); + +// slackbot.skills.create +// -- sad path +expectError(web.slackbot.skills.create()); // lacking argument +expectError(web.slackbot.skills.create({})); // empty argument +expectError( + web.slackbot.skills.create({ + instructions: '# Purpose', // missing display_name + }), +); +expectError( + web.slackbot.skills.create({ + display_name: 'Daily priorities', // missing instructions or canvas_id + }), +); +expectError( + web.slackbot.skills.create({ + display_name: 'Daily priorities', + instructions: '# Purpose', // both instructions and canvas_id + canvas_id: 'F1234', + }), +); +expectError( + web.slackbot.skills.create({ + display_name: 'Daily priorities', + instructions: '# Purpose', + category: 'cooking', // invalid category + }), +); +expectError( + web.slackbot.skills.create({ + display_name: 'Daily priorities', + instructions: '# Purpose', + mcp_servers: ['A1234'], // mcp_servers are objects + }), +); +expectError( + web.slackbot.skills.create({ + display_name: 'Daily priorities', + instructions: '# Purpose', + mcp_servers: [{ app_id: 'A1234' }], // missing service_type + }), +); +// -- happy path +expectAssignable>([ + { + display_name: 'Daily priorities', + instructions: '# Purpose\nSuggest the three most important things to work on today.', + }, +]); +expectAssignable>([ + { + display_name: 'Daily priorities', + canvas_id: 'F1234', + }, +]); +expectAssignable>([ + { + display_name: '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', + example_prompt: 'Run {skill} for today', + mcp_servers: [{ service_type: 'app', app_id: 'A1234', server_id: 'Amcp1234' }], + }, +]); From d6940d8a6f2aae1bf8ed252ec6beaa8175f7111f Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:59:28 -0800 Subject: [PATCH 2/3] chore(web-api): regenerate SlackbotSkillsCreateResponse from the recorded java-slack-sdk sample Co-Authored-By: Claude --- .../src/types/response/SlackbotSkillsCreateResponse.ts | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts b/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts index 09a6e94c8..a905ce5d3 100644 --- a/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts +++ b/packages/web-api/src/types/response/SlackbotSkillsCreateResponse.ts @@ -14,6 +14,7 @@ export type SlackbotSkillsCreateResponse = WebAPICallResult & { needed?: string; ok?: boolean; provided?: string; + response_metadata?: ResponseMetadata; skill?: Skill; warning?: string; }; @@ -24,6 +25,10 @@ export interface InvalidmcpServer { service_type?: string; } +export interface ResponseMetadata { + messages?: string[]; +} + export interface Skill { access?: string; category?: string; From f081dce57d9ef74f0222ea85f58f247929a0275e Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Thu, 12 Nov 2026 16:34:45 -0800 Subject: [PATCH 3/3] refactor: accept instructions or canvas_id as optional slackbot.skills.create arguments Leaves the exactly-one-of check to the API, which returns invalid_arguments, and the JSDoc. Also line-breaks the mcp_servers object type. Co-Authored-By: Claude --- .../web-api/src/types/request/slackbot.ts | 70 +++++++++---------- .../test/types/methods/slackbot.test-d.ts | 17 ++--- 2 files changed, 38 insertions(+), 49 deletions(-) diff --git a/packages/web-api/src/types/request/slackbot.ts b/packages/web-api/src/types/request/slackbot.ts index c671707fb..2734bd8e1 100644 --- a/packages/web-api/src/types/request/slackbot.ts +++ b/packages/web-api/src/types/request/slackbot.ts @@ -1,42 +1,38 @@ import type { TokenOverridable } from './common'; // https://docs.slack.dev/reference/methods/slackbot.skills.create -export type SlackbotSkillsCreateArguments = TokenOverridable & { +export interface SlackbotSkillsCreateArguments extends TokenOverridable { /** @description Human-readable label. Max 255 characters; not unique. */ display_name: string; -} & ( - | { - /** @description Markdown body of the skill. Send exactly one of `instructions` or `canvas_id`. */ - instructions: string; - canvas_id?: never; - } - | { - instructions?: never; - /** @description Canvas the caller owns to turn into a skill. Send exactly one of `instructions` or `canvas_id`. */ - canvas_id: string; - } - ) & { - /** @description When Slackbot should use the skill. Max 400 characters. */ - description?: string; - /** @description One of the skill categories. */ - category?: - | 'communication' - | 'customer_support' - | 'data_and_analytics' - | 'engineering' - | 'other' - | 'product_management' - | 'productivity' - | 'professional_development' - | 'project_management' - | 'sales' - | 'system' - | 'team_management'; - /** @description Max 200 characters. May contain `{skill}`, which becomes the skill mention. */ - example_prompt?: string; - /** - * @description Apps the skill needs, capped at the caller's MCP server limit. Declaring an app doesn't grant - * access to it. - */ - mcp_servers?: { service_type: string; app_id?: string; server_id?: string }[]; - }; + /** @description Markdown body of the skill. Send exactly one of `instructions` or `canvas_id`. */ + instructions?: string; + /** @description Canvas the caller owns to turn into a skill. Send exactly one of `instructions` or `canvas_id`. */ + canvas_id?: string; + /** @description When Slackbot should use the skill. Max 400 characters. */ + description?: string; + /** @description One of the skill categories. */ + category?: + | 'communication' + | 'customer_support' + | 'data_and_analytics' + | 'engineering' + | 'other' + | 'product_management' + | 'productivity' + | 'professional_development' + | 'project_management' + | 'sales' + | 'system' + | 'team_management'; + /** @description Max 200 characters. May contain `{skill}`, which becomes the skill mention. */ + example_prompt?: string; + /** + * @description Apps the skill needs, capped at the caller's MCP server limit. Declaring an app doesn't grant + * access to it. + */ + mcp_servers?: { + service_type: string; + app_id?: string; + server_id?: string; + }[]; +} diff --git a/packages/web-api/test/types/methods/slackbot.test-d.ts b/packages/web-api/test/types/methods/slackbot.test-d.ts index f41cee435..b10644bbb 100644 --- a/packages/web-api/test/types/methods/slackbot.test-d.ts +++ b/packages/web-api/test/types/methods/slackbot.test-d.ts @@ -12,18 +12,6 @@ expectError( instructions: '# Purpose', // missing display_name }), ); -expectError( - web.slackbot.skills.create({ - display_name: 'Daily priorities', // missing instructions or canvas_id - }), -); -expectError( - web.slackbot.skills.create({ - display_name: 'Daily priorities', - instructions: '# Purpose', // both instructions and canvas_id - canvas_id: 'F1234', - }), -); expectError( web.slackbot.skills.create({ display_name: 'Daily priorities', @@ -46,6 +34,11 @@ expectError( }), ); // -- happy path +expectAssignable>([ + { + display_name: 'Daily priorities', // the api requires exactly one of instructions or canvas_id + }, +]); expectAssignable>([ { display_name: 'Daily priorities',