Skip to content

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

Open
mwbrooks wants to merge 2 commits into
mainfrom
mwbrooks-preinstall-slack-skills
Open

mwbrooks wants to merge 2 commits 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.
  • 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.
  • .gitignore now ignores everything in .claude/ except skills/, so the Claude Code copy is committed.
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! 🤖 ✨

🙈 Nice catch on the .gitignore change so .claude/skills/ is tracked while the rest of .claude/ stays ignored!

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.

2 participants