feat(web-api): add slackbot.skills.delete method

.changeset/slackbot-skills-delete.md

@@ -0,0 +1,5 @@
+---
+"@slack/web-api": minor
+---
+
+feat(web-api): add [`slackbot.skills.delete`](https://docs.slack.dev/reference/methods/slackbot.skills.delete) method

packages/web-api/src/methods.ts

@@ -239,6 +239,7 @@ import type {
   SearchFilesArguments,
   SearchMessagesArguments,
   SlackbotSkillsCreateArguments,
+  SlackbotSkillsDeleteArguments,
   SlackbotSkillsInfoArguments,
   SlackbotSkillsLibraryAddArguments,
   SlackbotSkillsLibraryRemoveArguments,
@@ -533,6 +534,7 @@ import type {
   SearchFilesResponse,
   SearchMessagesResponse,
   SlackbotSkillsCreateResponse,
+  SlackbotSkillsDeleteResponse,
   SlackbotSkillsInfoResponse,
   SlackbotSkillsLibraryAddResponse,
   SlackbotSkillsLibraryRemoveResponse,
@@ -2413,6 +2415,11 @@ export abstract class Methods extends EventEmitter<WebClientEvent> {
        * @see {@link https://docs.slack.dev/reference/methods/slackbot.skills.create `slackbot.skills.create` API reference}.
        */
       create: bindApiCall<SlackbotSkillsCreateArguments, SlackbotSkillsCreateResponse>(this, 'slackbot.skills.create'),
+      /**
+       * @description Deletes a Slackbot skill and its canvas, and removes it from every library, skill set, and the org catalog.
+       * @see {@link https://docs.slack.dev/reference/methods/slackbot.skills.delete `slackbot.skills.delete` API reference}.
+       */
+      delete: bindApiCall<SlackbotSkillsDeleteArguments, SlackbotSkillsDeleteResponse>(this, 'slackbot.skills.delete'),
       /**
        * @description Returns one Slackbot skill, including its instructions.
        * @see {@link https://docs.slack.dev/reference/methods/slackbot.skills.info `slackbot.skills.info` API reference}.

packages/web-api/src/types/request/index.ts

@@ -299,6 +299,7 @@ export type {
 } from './search';
 export type {
   SlackbotSkillsCreateArguments,
+  SlackbotSkillsDeleteArguments,
   SlackbotSkillsInfoArguments,
   SlackbotSkillsLibraryAddArguments,
   SlackbotSkillsLibraryRemoveArguments,

packages/web-api/src/types/request/slackbot.ts

@@ -38,6 +38,12 @@ export interface SlackbotSkillsCreateArguments extends TokenOverridable {
     server_id?: string;
   }[];
 }
+// https://docs.slack.dev/reference/methods/slackbot.skills.delete
+export interface SlackbotSkillsDeleteArguments extends TokenOverridable {
+  /** @description Skill to delete. */
+  skill_id: string;
+}
+
 // https://docs.slack.dev/reference/methods/slackbot.skills.info
 export interface SlackbotSkillsInfoArguments extends TokenOverridable {
   /** @description Skill to fetch: a canvas file ID or a `builtin:` reference. */

packages/web-api/src/types/response/SlackbotSkillsDeleteResponse.ts

@@ -0,0 +1,22 @@
+/////////////////////////////////////////////////////////////////////////////////////////
+//                                                                                     //
+// !!! 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 SlackbotSkillsDeleteResponse = WebAPICallResult & {
+  error?: string;
+  needed?: string;
+  ok?: boolean;
+  provided?: string;
+  response_metadata?: ResponseMetadata;
+  warning?: string;
+};
+
+export interface ResponseMetadata {
+  messages?: string[];
+}

packages/web-api/src/types/response/index.ts

@@ -297,6 +297,7 @@ export { SearchAllResponse } from './SearchAllResponse';
 export { SearchFilesResponse } from './SearchFilesResponse';
 export { SearchMessagesResponse } from './SearchMessagesResponse';
 export { SlackbotSkillsCreateResponse } from './SlackbotSkillsCreateResponse';
+export { SlackbotSkillsDeleteResponse } from './SlackbotSkillsDeleteResponse';
 export { SlackbotSkillsInfoResponse } from './SlackbotSkillsInfoResponse';
 export { SlackbotSkillsLibraryAddResponse } from './SlackbotSkillsLibraryAddResponse';
 export { SlackbotSkillsLibraryRemoveResponse } from './SlackbotSkillsLibraryRemoveResponse';

packages/web-api/test/types/methods/slackbot.test-d.ts

@@ -62,6 +62,17 @@ expectAssignable<Parameters<typeof web.slackbot.skills.create>>([
   },
 ]);
 
+// slackbot.skills.delete
+// -- sad path
+expectError(web.slackbot.skills.delete()); // lacking argument
+expectError(web.slackbot.skills.delete({})); // empty argument
+// -- happy path
+expectAssignable<Parameters<typeof web.slackbot.skills.delete>>([
+  {
+    skill_id: 'F1234',
+  },
+]);
+
 // slackbot.skills.info
 // -- sad path
 expectError(web.slackbot.skills.info()); // lacking argument