Skip to content

Commit f38bbf9

Browse files
sjnimsclaude
andcommitted
chore: improve GitHub templates and bump claude-code-action
- Bump anthropics/claude-code-action from v1.0.30 to v1.0.33 - Enhance issue templates with categorization dropdowns, contribution checkboxes, and explicit validations - Improve discussion templates with project-specific options and relative links - Add MCP tool requirements section to CLAUDE.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 3eb5459 commit f38bbf9

16 files changed

Lines changed: 362 additions & 111 deletions

.github/DISCUSSION_TEMPLATE/ideas.yml

Lines changed: 62 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,13 @@ body:
44
- type: markdown
55
attributes:
66
value: |
7-
Thanks for sharing your idea! Help us understand what problem you're solving and your proposed solution.
7+
Thanks for sharing your idea! This plugin helps developers create Claude Code plugins
8+
with skills, agents, commands, hooks, and MCP integrations.
89
9-
**Before submitting**: Check [existing ideas](https://github.com/sjnims/plugin-dev/discussions/categories/ideas) and review our [contribution guidelines](https://github.com/sjnims/plugin-dev/blob/main/CONTRIBUTING.md).
10+
Ideas can be about **new skills**, **development workflows**, **validation tooling**,
11+
**documentation patterns**, or **marketplace features**.
12+
13+
**Before submitting**: Check [existing ideas](../../discussions/categories/ideas).
1014
1115
- type: checkboxes
1216
id: checklist
@@ -15,41 +19,86 @@ body:
1519
options:
1620
- label: I've searched existing ideas and discussions
1721
required: true
18-
- label: I've checked the README for related features
19-
required: true
22+
23+
- type: dropdown
24+
id: idea-type
25+
attributes:
26+
label: Idea Type
27+
description: "What area does this idea improve?"
28+
options:
29+
- Skill development patterns
30+
- Agent development patterns
31+
- Command development patterns
32+
- Hook development patterns
33+
- MCP integration patterns
34+
- Plugin structure / scaffolding
35+
- Validation tooling
36+
- Marketplace features
37+
- Documentation
38+
- Other
39+
validations:
40+
required: true
41+
42+
- type: dropdown
43+
id: component-type
44+
attributes:
45+
label: Component Type (if applicable)
46+
description: "Does this relate to a specific plugin component?"
47+
options:
48+
- Not component-specific
49+
- Skills
50+
- Agents
51+
- Commands
52+
- Hooks
53+
- MCP Servers
54+
- Plugin manifest (plugin.json)
55+
- Marketplace manifest
56+
validations:
57+
required: false
2058

2159
- type: textarea
2260
id: problem
2361
attributes:
2462
label: Problem or Need
25-
description: What problem does this idea solve? What need does it address?
26-
placeholder: "I'm frustrated when... I need a way to..."
63+
description: "What problem does this idea solve?"
64+
placeholder: |
65+
Example: "The skill-development skill doesn't cover dynamic argument generation..."
66+
Example: "There's no guidance on testing hooks before deployment..."
2767
validations:
2868
required: true
2969

3070
- type: textarea
3171
id: solution
3272
attributes:
3373
label: Proposed Idea
34-
description: Describe your idea clearly
35-
placeholder: I think it would be great if...
74+
description: "Describe your idea clearly"
3675
validations:
3776
required: true
3877

3978
- type: textarea
4079
id: benefit
4180
attributes:
4281
label: Expected Benefit
43-
description: How would this improve the plugin?
44-
placeholder: This would help users by...
82+
description: "How would this improve the plugin?"
83+
placeholder: |
84+
- Faster plugin development for...
85+
- Better documentation of...
86+
- Reduced errors when...
4587
validations:
46-
required: true
88+
required: false
4789

4890
- type: textarea
4991
id: alternatives
5092
attributes:
5193
label: Alternatives Considered
52-
description: Have you thought of other ways to achieve this?
53-
placeholder: Instead of this, we could also...
94+
description: "Have you considered other approaches?"
5495
validations:
5596
required: false
97+
98+
- type: checkboxes
99+
id: contribution
100+
attributes:
101+
label: Contribution interest
102+
options:
103+
- label: I'd be willing to help implement this idea
104+
required: false

.github/DISCUSSION_TEMPLATE/q-a.yml

Lines changed: 38 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,63 +4,88 @@ body:
44
- type: markdown
55
attributes:
66
value: |
7-
Have a question about using the plugin? We're here to help!
7+
Have a question about the plugin-dev toolkit? This could be about:
8+
- **Skills** - creation, triggering, progressive disclosure
9+
- **Agents** - creation, AI generation, tool configuration
10+
- **Commands** - slash commands, arguments, frontmatter
11+
- **Hooks** - events, prompt-based hooks
12+
- **MCP** - server integration, configuration
13+
- **Plugin structure** - manifests, file organization
814
9-
**Before asking**: Please check the [README](https://github.com/sjnims/plugin-dev/blob/main/README.md) and existing discussions first.
15+
**Resources**: [README](../../blob/main/README.md) | [CLAUDE.md](../../blob/main/CLAUDE.md) | [docs/](../../blob/main/docs/)
1016
1117
- type: checkboxes
1218
id: checklist
1319
attributes:
1420
label: Pre-submission checklist
1521
options:
16-
- label: I've checked the README.md
17-
required: true
18-
- label: I've searched existing discussions for similar questions
22+
- label: I've checked the README, CLAUDE.md, and searched existing discussions
1923
required: true
2024

2125
- type: dropdown
2226
id: category
2327
attributes:
2428
label: Question Category
29+
description: "What area is your question about?"
2530
options:
2631
- Installation and setup
2732
- Skills (creation, triggering)
2833
- Agents (creation, AI generation)
29-
- Hooks (events, prompt-based)
3034
- Commands (slash commands)
35+
- Hooks (events, prompt-based)
3136
- MCP integration
3237
- Plugin structure
3338
- Marketplace creation
39+
- Validation tooling
3440
- Troubleshooting
3541
- Contributing
3642
- Other
3743
validations:
3844
required: true
3945

46+
- type: dropdown
47+
id: component-type
48+
attributes:
49+
label: Component Type (if applicable)
50+
description: "Which plugin component is involved?"
51+
options:
52+
- Not component-specific
53+
- Skill
54+
- Agent
55+
- Command
56+
- Hook
57+
- MCP Server
58+
- Plugin manifest (plugin.json)
59+
- Marketplace manifest
60+
validations:
61+
required: false
62+
4063
- type: textarea
4164
id: question
4265
attributes:
4366
label: Your Question
44-
description: What would you like to know?
45-
placeholder: How do I...? Why does...? Can I...?
67+
description: "What would you like to know?"
4668
validations:
4769
required: true
4870

4971
- type: textarea
5072
id: context
5173
attributes:
5274
label: Additional Context
53-
description: Any relevant details about your setup or use case
54-
placeholder: I'm trying to...
75+
description: "Any relevant details: error messages, configuration snippets, file structure"
76+
placeholder: |
77+
```yaml
78+
# Paste relevant config or file contents here
79+
```
5580
validations:
5681
required: false
5782

5883
- type: input
5984
id: claude-code-version
6085
attributes:
61-
label: Claude Code Version (for troubleshooting)
62-
description: "Run `claude --version` to find this"
63-
placeholder: "e.g., 1.0.0"
86+
label: Claude Code Version
87+
description: "Run `claude --version` (helpful for troubleshooting)"
88+
placeholder: "e.g., 1.0.30"
6489
validations:
6590
required: false
6691

.github/DISCUSSION_TEMPLATE/show-and-tell.yml

Lines changed: 65 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,47 +4,95 @@ body:
44
- type: markdown
55
attributes:
66
value: |
7-
Share how you're using plugin-dev! We'd love to hear about your projects and learnings.
7+
Share what you've built with plugin-dev! This could be:
8+
- **Complete plugins** you've created
9+
- **Skills** with interesting triggering patterns
10+
- **Agents** with custom tool configurations
11+
- **Hooks** solving real workflow problems
12+
- **Commands** with dynamic arguments
13+
- **Marketplace** setups for distributing plugins
14+
- **Lessons learned** from plugin development
15+
16+
**Tip**: Include code snippets, before/after comparisons, or configuration examples.
17+
18+
- type: checkboxes
19+
id: checklist
20+
attributes:
21+
label: Pre-submission checklist
22+
options:
23+
- label: My showcase doesn't expose sensitive information (API keys, internal paths)
24+
required: true
25+
26+
- type: dropdown
27+
id: showcase-type
28+
attributes:
29+
label: What are you showcasing?
30+
description: "Select the type of showcase"
31+
options:
32+
- Complete plugin I built
33+
- Individual component (skill, agent, hook, command)
34+
- Interesting triggering pattern
35+
- Plugin structure or organization
36+
- Marketplace setup
37+
- CI/CD or automation integration
38+
- Lesson learned or gotcha discovered
39+
- Other
40+
validations:
41+
required: true
842

943
- type: dropdown
1044
id: component-type
1145
attributes:
12-
label: What type of component?
46+
label: Component Type (if applicable)
47+
description: "Which plugin component is involved?"
1348
options:
14-
- Complete plugin
49+
- Not component-specific
1550
- Skill
1651
- Agent
17-
- Hook
1852
- Command
19-
- Marketplace
20-
- Other
53+
- Hook
54+
- MCP Server
55+
- Multiple types
2156
validations:
22-
required: true
57+
required: false
2358

2459
- type: textarea
2560
id: showcase
2661
attributes:
27-
label: What are you sharing?
28-
description: Describe what you built or accomplished
29-
placeholder: I used plugin-dev to...
62+
label: What You're Sharing
63+
description: "Describe what you built or discovered"
3064
validations:
3165
required: true
3266

67+
- type: textarea
68+
id: code-examples
69+
attributes:
70+
label: Code or Configuration Examples
71+
description: "Share relevant snippets that others can learn from"
72+
placeholder: |
73+
```yaml
74+
# Example skill frontmatter, plugin.json excerpt, etc.
75+
```
76+
validations:
77+
required: false
78+
3379
- type: textarea
3480
id: learnings
3581
attributes:
3682
label: Key Learnings
37-
description: What did you learn that might help others? This is the heart of Show and Tell!
38-
placeholder: Tips I'd share...
83+
description: "What did you learn that might help others? This is the heart of Show & Tell!"
84+
placeholder: |
85+
The tricky part was...
86+
A tip for others: ...
87+
I was surprised to find...
3988
validations:
4089
required: true
4190

4291
- type: textarea
4392
id: links
4493
attributes:
4594
label: Links or Resources
46-
description: Any relevant links to your project, blog post, or resources
47-
placeholder: "GitHub repo: ... Blog post: ..."
95+
description: "Repository, blog post, or relevant links"
4896
validations:
4997
required: false
5098

@@ -53,5 +101,7 @@ body:
53101
attributes:
54102
label: Sharing preferences
55103
options:
56-
- label: I'm okay with this being featured in project documentation
104+
- label: This can be featured in project documentation
105+
required: false
106+
- label: Code snippets can be shared as examples
57107
required: false

0 commit comments

Comments
 (0)