Skip to content

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

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 to each app folder (claude-agent-sdk/, openai-agents-sdk/, pydantic-ai/). They're in .claude/skills/ for Claude Code and .agents/skills/ for Codex, Cursor, and other agents that read that 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 docs M-T: Documentation work only 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! Each app gets its own copy of the skills, matching slackapi/slack-skills-plugin on main file for file, in 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 b01e844 into main Nov 16, 2026
8 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

docs M-T: Documentation work only

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants