Skip to content

docs: update README.md with install and feature sections#61

Merged
mwbrooks merged 6 commits into
mainfrom
mwbrooks-readme-skills-plugin
Jun 29, 2026
Merged

docs: update README.md with install and feature sections#61
mwbrooks merged 6 commits into
mainfrom
mwbrooks-readme-skills-plugin

Conversation

@mwbrooks

@mwbrooks mwbrooks commented Jun 25, 2026

Copy link
Copy Markdown
Member

Summary

This pull request updates the README.md to be the front door for external Claude Code and Cursor users, instead of plugin maintainers.

  • Renames the title to Slack MCP and Skills Plugin and adds a tagline.
  • Adds CI / license badges.
  • Moves Installation above Features so the first action a reader can take is install.
  • Documents the official Claude marketplace install (/plugin install slack@claude-plugins-official) alongside the existing Cursor deeplink.
  • Lists the complete features: MCP server capabilities, all six skills, and all five slash commands.
  • Adds developer-focused usage examples (create a Slack app, build a Block Kit feedback modal, validate Block Kit JSON from a file).
  • Links to the contributor and maintainer guides for contributions.

Testing

  • Open the rendered README in the GitHub PR preview and confirm the title, badges, Cursor "Install MCP Server" button, and all section headings render correctly.

Refocuses the README on Claude Code and Cursor end users instead of
plugin maintainers. Title becomes "Slack MCP and Skills Plugin",
install section leads, Features lists the MCP server tools, the six
skills, and the five slash commands, and maintainer setup moves to
.github/contributing.md and .github/maintainers_guide.md.
@mwbrooks mwbrooks changed the title docs: rewrite README for external users docs: update README.md with install and feature sections Jun 25, 2026
@mwbrooks mwbrooks self-assigned this Jun 25, 2026
@mwbrooks mwbrooks added the documentation Improvements or additions to documentation label Jun 25, 2026
Mirrors the slackapi/slack-cli README: a single Contributing
section that links to .github/contributing.md (covers issues and
PRs) and to .github/maintainers_guide.md for local development.
@mwbrooks mwbrooks marked this pull request as ready for review June 25, 2026 23:26

@WilliamBergamin WilliamBergamin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This is great 💯 much better then what we had

My only blocker is around the description of the project I think we can make it shorter and more general?

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
We welcome contributions from everyone! Please check out our [contributor's guide](.github/contributing.md) for guidelines on opening issues and pull requests.

## Questions or Issues?
Working on the plugin itself? See the [maintainer's guide](.github/maintainers_guide.md) for local development setup.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Praise 🙏

Comment thread README.md

- **Remote server only**: This configuration connects to Slack's hosted MCP server. No local installation is required or supported.
- **Admin approval required**: Your Slack workspace administrator must approve MCP integration before you can use this feature.
We welcome contributions from everyone! Please check out our [contributor's guide](.github/contributing.md) for guidelines on opening issues and pull requests.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@mwbrooks

Copy link
Copy Markdown
Member Author

Thanks for the quick review @WilliamBergamin! I've brought in one of your suggestions and incorporated your other suggestion to shorted the tagline.

Let me know what you think!

@mwbrooks mwbrooks requested a review from WilliamBergamin June 29, 2026 16:39
Co-authored-by: William Bergamin <wbergamin@salesforce.com>
Comment thread README.md Outdated

@WilliamBergamin WilliamBergamin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good 💯 great upgrade 🚀

@mwbrooks

Copy link
Copy Markdown
Member Author

Thanks for the review @WilliamBergamin! We can keep iterating on the README.md but I think this is much better than what we have today. Let's ship it. :shipit:

@mwbrooks mwbrooks merged commit 10e40bd into main Jun 29, 2026
4 checks passed
@mwbrooks mwbrooks deleted the mwbrooks-readme-skills-plugin branch June 29, 2026 19:51
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