Skip to content

feat(web-api): add slackbot.skills.create method - #2831

Merged
zimeg merged 4 commits into
mainfrom
zimeg-feat-slackbot-skills-create
Nov 13, 2026
Merged

zimeg merged 4 commits into
mainfrom
zimeg-feat-slackbot-skills-create

Conversation

@zimeg

@zimeg zimeg commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

Summary

This pull request adds the slackbot.skills.create method to @slack/web-api.

  • client.slackbot.skills.create() takes a required display_name. The optional arguments are instructions, canvas_id, description, category, example_prompt, and mcp_servers. The API takes exactly one of instructions or canvas_id and returns invalid_arguments otherwise, as their JSDoc notes.
  • mcp_servers items are { service_type, app_id?, server_id? } objects. The reference only says array, so this shape comes from the live API, which rejects strings and unknown keys. An app's MCP server needs service_type: 'app', app_id, and server_id.
  • SlackbotSkillsCreateResponse includes the created skill, and invalid_mcp_servers for mcp_server_not_found.
  • SlackbotSkillsCreateResponse is generated with scripts/code_generator.rb from the json-logs/samples/api/slackbot.skills.create.json sample recorded live in feat: add slackbot.skills.create method java-slack-sdk#1685.
  • Adds type tests and a minor changeset.

This is part 1 of 11 in a stack that adds the Slackbot skills methods one at a time, following a skill from creation to deletion. Each pull request builds on the one before it and merges on its own, bottom to top. It replaces #2830.

  1. feat(web-api): add slackbot.skills.create method #2831 slackbot.skills.create 👈 this pull request
  2. feat(web-api): add slackbot.skills.info method #2832 slackbot.skills.info
  3. feat(web-api): add slackbot.skills.update method #2833 slackbot.skills.update
  4. feat(web-api): add slackbot.skills.list method #2834 slackbot.skills.list
  5. feat(web-api): add slackbot.skills.library.add method #2835 slackbot.skills.library.add
  6. feat(web-api): add slackbot.skills.library.remove method #2836 slackbot.skills.library.remove
  7. feat(web-api): add admin.slackbot.skills.list method #2837 admin.slackbot.skills.list
  8. feat(web-api): add admin.slackbot.skills.publish method #2838 admin.slackbot.skills.publish
  9. feat(web-api): add admin.slackbot.skills.setAutoEnabled method #2839 admin.slackbot.skills.setAutoEnabled
  10. feat(web-api): add admin.slackbot.skills.unpublish method #2840 admin.slackbot.skills.unpublish
  11. feat(web-api): add slackbot.skills.delete method #2841 slackbot.skills.delete

Testing

  1. Call client.slackbot.skills.create({ display_name: 'Daily priorities', instructions: '# Purpose' }) with a skills:write token and confirm skill.id comes back.
  2. Call it again with a canvas_id of a canvas you own, and without instructions, and confirm the canvas becomes the skill.

Each layer of this stack was checked against an Enterprise developer sandbox by running every method added so far, in order, with that layer's WebClient.

Requirements

🤖 Generated with Claude Code

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg zimeg added this to the web-api@next milestone Nov 12, 2026
@zimeg zimeg added semver:minor enhancement M-T: A feature request for new functionality area:typescript issues that specifically impact using the package from typescript projects pkg:web-api applies to `@slack/web-api` labels Nov 12, 2026
@zimeg zimeg self-assigned this Nov 12, 2026
@changeset-bot

changeset-bot Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f081dce

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@slack/web-api Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@codecov

codecov Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.33%. Comparing base (5257234) to head (f081dce).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2831      +/-   ##
==========================================
- Coverage   94.33%   94.33%   -0.01%     
==========================================
  Files          67       67              
  Lines       10663    10675      +12     
  Branches      683      683              
==========================================
+ Hits        10059    10070      +11     
  Misses        575      575              
- Partials       29       30       +1     
Flag Coverage Δ
cli-hooks 94.18% <100.00%> (+<0.01%) ⬆️
cli-test 94.18% <100.00%> (+<0.01%) ⬆️
logger 94.18% <100.00%> (+<0.01%) ⬆️
oauth 94.18% <100.00%> (+<0.01%) ⬆️
socket-mode 94.18% <100.00%> (+<0.01%) ⬆️
web-api 94.18% <100.00%> (+<0.01%) ⬆️
webhook 94.18% <100.00%> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

zimeg and others added 2 commits November 11, 2026 22:59
@zimeg
zimeg marked this pull request as ready for review November 12, 2026 23:42
@zimeg
zimeg requested a review from a team as a code owner November 12, 2026 23:42

@zimeg zimeg left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

seeming solid we want to merge java (before landing this . please update tests however

…s.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 <svc-devxp-claude@slack-corp.com>
@zimeg zimeg changed the title feat: add slackbot.skills.create method feat(web-api): add slackbot.skills.create method Nov 13, 2026
@zimeg
zimeg merged commit c067369 into main Nov 13, 2026
22 checks passed
@zimeg
zimeg deleted the zimeg-feat-slackbot-skills-create branch November 13, 2026 06:33
@zimeg

zimeg commented Nov 13, 2026

Copy link
Copy Markdown
Member Author

📝 Merged with admin rights and no approving review, to unblock the stack for this week's release. Here's what that rests on:

A follow-up review is still welcome here, and any fix can land as a new pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:typescript issues that specifically impact using the package from typescript projects enhancement M-T: A feature request for new functionality pkg:web-api applies to `@slack/web-api` semver:minor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant