Skip to content

feat(methods): add slackbot.skills and admin.slackbot.skills method examples - #390

Closed
zimeg wants to merge 1 commit into
mainfrom
zimeg-feat-slackbot-skills-examples
Closed

zimeg wants to merge 1 commit into
mainfrom
zimeg-feat-slackbot-skills-examples

Conversation

@zimeg

@zimeg zimeg commented Nov 11, 2026

Copy link
Copy Markdown
Member

Summary

This pull request adds Web API method examples for the Slackbot skills methods, as a proof of concept:

  • methods/src/slackbot/skills/ has slackbot.skills.create, delete, info, list, and update.
  • methods/src/slackbot/skills/library/ has slackbot.skills.library.add and slackbot.skills.library.remove.
  • methods/src/admin/slackbot/skills/ has admin.slackbot.skills.list, publish, setAutoEnabled, and unpublish.
  • Each family is laid out like agents/conversations/, with one directory per method family, its own .slack/ config and manifest.json. The skills manifests declare skills:read and skills:write bot scopes. The admin manifest declares the admin.skills:read and admin.skills:write user scopes, since the admin methods need a user token from an org-level install.
  • The methods README lists both families.

The reference pages don't have an example request, so each example passes every argument the page documents. Values are the page's defaults or come from its example responses. slackbot.skills.create passes instructions and not canvas_id, since only one of the two can be sent.

Dependency

These methods are added to @slack/web-api in slackapi/node-slack-sdk#2830, which isn't released yet. This PR stays a draft until that version ships and methods/package.json is bumped to it. Until then the npm run check CI step fails with Property 'slackbot' does not exist. That's expected.

Testing

This was run against an Enterprise developer sandbox with the slackapi/node-slack-sdk#2830 build installed (npm install --no-save) and an org-installed user token:

  • With that build, npm run check passes for all 11 examples. Against the published 8.3.0 it fails for each one.
  • All 11 examples, unedited, reached the API and passed its argument validation. With the placeholder IDs they return API errors such as skill_not_found, mcp_server_not_found, and invalid_cursor.
  • With real IDs swapped in locally, 10 returned ok: create, info, update, library.remove, library.add, list, admin.slackbot.skills.list, publish, unpublish, and delete. create and update ran without mcp_servers, and both list methods ran without cursor.
  • setAutoEnabled returned usergroup_not_found, because no real user group was available for usergroup_ids.
  • lack manifest validate passes for all three manifests.

To repeat it:

  1. cd methods/src/slackbot/skills, install the app with slack install --environment local, and export a token with the skills:read and skills:write scopes as SLACK_TOKEN.
  2. Run slack run slackbot-skills-create.js (drop mcp_servers unless you have an MCP-enabled app). Copy the skill.id into the other examples in place of F0123ABCD and run them, finishing with slackbot-skills-delete.js.
  3. Repeat from methods/src/admin/slackbot/skills with an org-installed user token that has admin.skills:read and admin.skills:write.

🤖 Generated with Claude Code

…xamples

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg

zimeg commented Nov 12, 2026

Copy link
Copy Markdown
Member Author

Closing this in favor of a stack that adds one method example per pull request, each linked to its @slack/web-api pull request: #396 slackbot.skills.create through #406 slackbot.skills.delete. The arguments now follow the reference's order and match the Python examples. The branch is kept.

@zimeg zimeg closed this Nov 12, 2026
@zimeg
zimeg deleted the zimeg-feat-slackbot-skills-examples branch November 14, 2026 21:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request javascript Pull requests that update javascript code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant