Skip to content

chore: pre-install the Slack skills for coding agents - #395

Merged
mwbrooks merged 1 commit into
mainfrom
mwbrooks-preinstall-slack-skills
Nov 16, 2026
Merged

mwbrooks merged 1 commit into
mainfrom
mwbrooks-preinstall-slack-skills

Conversation

@mwbrooks

Copy link
Copy Markdown
Member

Summary

This pull request gives developers who build this sample with a coding agent the Slack skills in the project from the start, so the agent knows how to create, run, test, and deploy a Slack app without installing the Slack plugin first. It follows the same layout as slack-samples/bolt-js-starter-template#184.

  • The 9 skills from slackapi/slack-skills-plugin are added with npx skills add --copy. They're in .claude/skills/ for Claude Code and .agents/skills/ for Codex, Cursor, and other agents that read that folder.
  • The skills are added once at the repo root, not in each example folder.
  • skills-lock.json records where each skill came from, so npx skills update -p -y can update them later.
  • .gitattributes marks the 9 Slack skills by name and the lock file as generated, so GitHub collapses them in diffs. Skills a developer adds later still show in diffs.
npx skills add slackapi/slack-skills-plugin --skill '*' -a universal -a claude-code --copy -y

Testing

  • Installed with skills 1.8.1, which records installMode: "copy" in skills-lock.json. No skill is a symlink.
  • Claude Code, Codex, Cursor, and OpenCode were checked against the same layout on bolt-js-starter-template#184.

Notes

  • The skills come from the plugin's main branch, which skills-lock.json doesn't pin. A follow-up PR adds a workflow that keeps them up to date.
  • The skills are copied, not symlinked, so they still work in projects created from this sample on any platform.

Adds the 9 skills from slackapi/slack-skills-plugin with npx skills add --copy,
for Claude Code (.claude/skills) and agents that read .agents/skills, with a
skills-lock.json. Marks them generated so GitHub collapses them in diffs, and
keeps them out of the formatter so they stay identical to the plugin.
@mwbrooks mwbrooks self-assigned this Nov 15, 2026
@mwbrooks
mwbrooks marked this pull request as ready for review November 15, 2026 21:51
@mwbrooks
mwbrooks requested a review from a team as a code owner November 15, 2026 21:51
@zimeg zimeg added the documentation Improvements or additions to documentation label Nov 15, 2026

@zimeg zimeg left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

🧰 @mwbrooks LGTM! The skills match slackapi/slack-skills-plugin on main file for file and follow the same layout as slack-samples/bolt-js-starter-template#184. Excited for coding agents to have these from the very first prompt! 🤖 ✨

@mwbrooks

Copy link
Copy Markdown
Member Author

Thanks @zimeg for reviewing all of these! 🙇

@mwbrooks
mwbrooks merged commit ca549ef into main Nov 16, 2026
16 checks passed
@mwbrooks
mwbrooks deleted the mwbrooks-preinstall-slack-skills branch November 16, 2026 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants