Skip to content

Commit 3f73fc7

Browse files
mwbrooksmwbrooks
authored
chore: add GitHub issue templates split by mcp and skills (#89)
* feat(issue-templates): split issues by MCP vs Skills for triage Adds six YAML issue forms plus a config.yml under .github/ISSUE_TEMPLATE/. Each template applies static `labels:` so triage routing happens at issue-creation time with no maintainer touch and no GitHub Actions: - 00-question → labels: [question] - 01-bug-mcp → labels: [bug, area:mcp] - 02-bug-skill → labels: [bug, area:skills] - 03-feature-mcp → labels: [enhancement, area:mcp] - 04-feature-skill → labels: [enhancement, area:skills] - 05-docs → labels: [docs] `config.yml` disables blank issues and points general Slack platform questions to the support link. The bug-skill template includes a "which skill or command?" dropdown so maintainers can drill into a specific surface without needing to read the body first. The `area:mcp` and `area:skills` labels were created on the repo before this PR so the templates can reference them. * fix(issue-templates): clarify MCP bugs route + support-link scope The Slack MCP Server lives in a separate repository, so bugs in the server itself can't be fixed here. Add a heads-up at the top of the MCP bug template noting that we can share feedback internally with the Slack MCP Server team, and point outage / rate-limit / team-specific errors at Slack Developer Platform Support instead. Also tightens the config.yml contact-link `about` copy to match — the support link is now scoped to the "your Slack team is broken" cases rather than "general platform questions." * refactor(issue-templates): generalize skill/command dropdown Replace the enumerated dropdown of every skill and slash command with: - a `Skill / Slash command / Not sure` dropdown - a free-text "Name of the skill or command" input Removes the ongoing sync tax on maintainers_guide.md and AGENTS.md. Every time we add or remove a skill or command, we would have had to update the dropdown, the maintainers guide, and AGENTS.md in lockstep. That kind of coupling always drifts. The user still tells us exactly which skill or command is affected via the free-text field. The dropdown is a fast triage signal (skill vs command vs uncertain). * chore: trigger changesets bot
1 parent 9ea300a commit 3f73fc7

7 files changed

Lines changed: 377 additions & 0 deletions

File tree

‎.github/ISSUE_TEMPLATE/00-question.yml‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
name: Question
2+
description: Ask a question about the Slack MCP or Skills plugin
3+
labels: ["question"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Have a question? Please provide as much context as possible so we can help.
9+
10+
- type: textarea
11+
id: question
12+
attributes:
13+
label: Question
14+
description: What would you like to know?
15+
validations:
16+
required: true
17+
18+
- type: textarea
19+
id: context
20+
attributes:
21+
label: Context
22+
description: |
23+
Anything you've already tried, links to relevant docs, or the outcome
24+
you're trying to reach.
25+
validations:
26+
required: false

‎.github/ISSUE_TEMPLATE/01-bug-mcp.yml‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
name: MCP bug
2+
description: Report a bug in the Slack MCP server or its tools
3+
labels: ["bug", "area:mcp"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Thank you for taking the time to report an MCP bug.
9+
10+
**Heads up:** this repository does not host the Slack MCP Server itself,
11+
so bugs in the MCP Server can't be fixed here — but we can share your
12+
feedback internally with the Slack MCP Server team.
13+
14+
For outages, rate limits, or other errors specific to your Slack team,
15+
please report the issue to
16+
[Slack Developer Platform Support](https://slack.com/help/requests/new)
17+
so they can work with you privately to diagnose and resolve it.
18+
19+
Please fill out as much detail as you can — repro steps and version
20+
info help us the most.
21+
22+
- type: input
23+
id: plugin-version
24+
attributes:
25+
label: Plugin version
26+
description: |
27+
Run `/plugin` inside Claude Code, or check the plugin listing in Cursor.
28+
placeholder: e.g., 1.1.0
29+
validations:
30+
required: true
31+
32+
- type: dropdown
33+
id: client
34+
attributes:
35+
label: Client
36+
description: Which AI tool were you using?
37+
options:
38+
- Claude Code
39+
- Cursor
40+
- Other (please describe below)
41+
validations:
42+
required: true
43+
44+
- type: input
45+
id: client-version
46+
attributes:
47+
label: Client version
48+
description: Version of Claude Code, Cursor, or your MCP client
49+
placeholder: e.g., Claude Code 2.0.14
50+
validations:
51+
required: true
52+
53+
- type: input
54+
id: os
55+
attributes:
56+
label: Operating System
57+
placeholder: e.g., macOS 14.5, Ubuntu 22.04, Windows 11
58+
validations:
59+
required: true
60+
61+
- type: textarea
62+
id: description
63+
attributes:
64+
label: Description
65+
description: What went wrong?
66+
validations:
67+
required: true
68+
69+
- type: textarea
70+
id: steps
71+
attributes:
72+
label: Steps to reproduce
73+
placeholder: |
74+
1. Ask the AI to "..."
75+
2. The MCP tool call to `...` runs
76+
3. See error / unexpected result
77+
validations:
78+
required: true
79+
80+
- type: textarea
81+
id: expected
82+
attributes:
83+
label: Expected result
84+
validations:
85+
required: true
86+
87+
- type: textarea
88+
id: actual
89+
attributes:
90+
label: Actual result
91+
description: Include error messages, tool responses, or screenshots.
92+
validations:
93+
required: true
94+
95+
- type: textarea
96+
id: extra
97+
attributes:
98+
label: Anything else?
99+
description: Optional. Logs, related issues, workspace permissions context, etc.
100+
validations:
101+
required: false

‎.github/ISSUE_TEMPLATE/02-bug-skill.yml‎

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
name: Skill or command bug
2+
description: Report a bug in a skill or slash command
3+
labels: ["bug", "area:skills"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Thank you for reporting a bug in a skill or slash command. Please tell us
9+
which skill or command is affected and how to reproduce it.
10+
11+
- type: dropdown
12+
id: kind
13+
attributes:
14+
label: Which is affected?
15+
options:
16+
- Skill
17+
- Slash command
18+
- Not sure
19+
validations:
20+
required: true
21+
22+
- type: input
23+
id: name
24+
attributes:
25+
label: Name of the skill or command
26+
description: |
27+
For example: `slack-messaging`, `create-slack-app`, `/slack:standup`.
28+
Leave blank if you're not sure.
29+
placeholder: e.g., slack-messaging or /slack:standup
30+
validations:
31+
required: false
32+
33+
- type: input
34+
id: plugin-version
35+
attributes:
36+
label: Plugin version
37+
description: |
38+
Run `/plugin` inside Claude Code, or check the plugin listing in Cursor.
39+
placeholder: e.g., 1.1.0
40+
validations:
41+
required: true
42+
43+
- type: dropdown
44+
id: client
45+
attributes:
46+
label: Client
47+
description: Which AI tool were you using?
48+
options:
49+
- Claude Code
50+
- Cursor
51+
- Other (please describe below)
52+
validations:
53+
required: true
54+
55+
- type: input
56+
id: client-version
57+
attributes:
58+
label: Client version
59+
description: Version of Claude Code, Cursor, or your MCP client
60+
placeholder: e.g., Claude Code 2.0.14
61+
validations:
62+
required: true
63+
64+
- type: input
65+
id: os
66+
attributes:
67+
label: Operating System
68+
placeholder: e.g., macOS 14.5, Ubuntu 22.04, Windows 11
69+
validations:
70+
required: true
71+
72+
- type: textarea
73+
id: description
74+
attributes:
75+
label: Description
76+
description: What went wrong?
77+
validations:
78+
required: true
79+
80+
- type: textarea
81+
id: steps
82+
attributes:
83+
label: Steps to reproduce
84+
description: What did you ask the AI, and what did the skill/command do?
85+
placeholder: |
86+
1. Ran `/slack:summarize-channel #general`
87+
2. ...
88+
3. Saw ...
89+
validations:
90+
required: true
91+
92+
- type: textarea
93+
id: expected
94+
attributes:
95+
label: Expected result
96+
validations:
97+
required: true
98+
99+
- type: textarea
100+
id: actual
101+
attributes:
102+
label: Actual result
103+
description: Include error messages, output, or screenshots.
104+
validations:
105+
required: true
106+
107+
- type: textarea
108+
id: extra
109+
attributes:
110+
label: Anything else?
111+
description: Optional. Logs, related issues, edge cases, etc.
112+
validations:
113+
required: false

‎.github/ISSUE_TEMPLATE/03-feature-mcp.yml‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
name: MCP feature request
2+
description: Request a new MCP tool or an improvement to the MCP server
3+
labels: ["enhancement", "area:mcp"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Have an idea for a new MCP tool or an improvement to an existing one?
9+
Tell us what problem you're trying to solve.
10+
11+
- type: textarea
12+
id: problem
13+
attributes:
14+
label: What problem are you trying to solve?
15+
description: Focus on the outcome, not a specific implementation.
16+
validations:
17+
required: true
18+
19+
- type: textarea
20+
id: proposal
21+
attributes:
22+
label: Proposed solution
23+
description: What would the new tool or improvement look like?
24+
validations:
25+
required: false
26+
27+
- type: textarea
28+
id: alternatives
29+
attributes:
30+
label: Alternatives considered
31+
description: Optional. Other tools, workflows, or workarounds you've tried.
32+
validations:
33+
required: false
34+
35+
- type: textarea
36+
id: extra
37+
attributes:
38+
label: Anything else?
39+
description: Optional. Related issues, links, examples.
40+
validations:
41+
required: false

‎.github/ISSUE_TEMPLATE/04-feature-skill.yml‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
name: Skill or command feature request
2+
description: Request a new skill, a new slash command, or an improvement to an existing one
3+
labels: ["enhancement", "area:skills"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Have an idea for a new skill, a new slash command, or an improvement to
9+
an existing one? Tell us what problem you're trying to solve.
10+
11+
- type: dropdown
12+
id: kind
13+
attributes:
14+
label: What kind of change is this?
15+
options:
16+
- New skill
17+
- New slash command
18+
- Improvement to an existing skill
19+
- Improvement to an existing slash command
20+
validations:
21+
required: true
22+
23+
- type: textarea
24+
id: problem
25+
attributes:
26+
label: What problem are you trying to solve?
27+
description: Focus on the outcome, not a specific implementation.
28+
validations:
29+
required: true
30+
31+
- type: textarea
32+
id: proposal
33+
attributes:
34+
label: Proposed solution
35+
description: |
36+
What would the new skill, command, or improvement look like? Include
37+
example prompts if you have them.
38+
validations:
39+
required: false
40+
41+
- type: textarea
42+
id: alternatives
43+
attributes:
44+
label: Alternatives considered
45+
description: Optional. Other tools, workflows, or workarounds you've tried.
46+
validations:
47+
required: false
48+
49+
- type: textarea
50+
id: extra
51+
attributes:
52+
label: Anything else?
53+
description: Optional. Related issues, links, examples.
54+
validations:
55+
required: false

‎.github/ISSUE_TEMPLATE/05-docs.yml‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
name: Documentation
2+
description: Report a problem or suggest an improvement to the documentation
3+
labels: ["docs"]
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
Thanks for helping improve the docs. Point us at the specific page or
9+
section and tell us what needs to change.
10+
11+
- type: input
12+
id: location
13+
attributes:
14+
label: Where is the docs issue?
15+
description: URL or path to the docs page, README section, or SKILL.md file.
16+
placeholder: e.g., https://docs.slack.dev/... or skills/block-kit/SKILL.md
17+
validations:
18+
required: true
19+
20+
- type: textarea
21+
id: problem
22+
attributes:
23+
label: What's wrong or missing?
24+
validations:
25+
required: true
26+
27+
- type: textarea
28+
id: suggestion
29+
attributes:
30+
label: Suggested change
31+
description: Optional. Draft text or a description of the fix.
32+
validations:
33+
required: false

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Slack Developer Platform Support
4+
url: https://slack.com/help/requests/new
5+
about: |
6+
For outages, rate limits, or other errors specific to your Slack team,
7+
please report the issue to Slack Developer Platform Support. They can
8+
work with you privately to diagnose and resolve the problem.

0 commit comments

Comments
 (0)