You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat: improve catalog submission templates and CODEOWNERS
Simplify the community catalog submission flow to use issue templates
with manual maintainer review (no automation scripts or workflows).
- Add explicit CODEOWNERS entries for catalog.community.json files so
submissions are automatically assigned to a maintainer for review
- Improve preset submission template:
- Add 'Required Extensions' optional field
- Make 'Templates Provided' optional (supports command-only presets)
- Add 'Number of Scripts' optional field
The existing extension and preset issue templates already collect all
required catalog metadata. Maintainers review submissions and manually
update the catalog JSON files.
Closes#2400
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -174,7 +174,7 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c
174
174
## 🧩 Community Extensions
175
175
176
176
> [!NOTE]
177
-
> Community extensions are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the extension code itself**. The Community Extensions website is also a third-party resource. Review extension source code before installation and use at your own discretion.
177
+
> Community extensions are independently created and maintained by their respective authors. Maintainers only verify that catalog entries are complete and correctly formatted — they do **not review, audit, endorse, or support the extension code itself**. The Community Extensions website is also a third-party resource. Review extension source code before installation and use at your own discretion.
178
178
179
179
🔍 **Browse and search community extensions on the [Community Extensions website](https://speckit-community.github.io/extensions/).**
Copy file name to clipboardExpand all lines: docs/community/presets.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
# Community Presets
2
2
3
3
> [!NOTE]
4
-
> Community presets are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the preset code itself**. Review preset source code before installation and use at your own discretion.
4
+
> Community presets are independently created and maintained by their respective authors. Maintainers only verify that catalog entries are complete and correctly formatted — they do **not review, audit, endorse, or support the preset code itself**. Review preset source code before installation and use at your own discretion.
5
5
6
6
The following community-contributed presets customize how Spec Kit behaves — overriding templates, commands, and terminology without changing any tooling. Presets are available in [`catalog.community.json`](https://github.com/github/spec-kit/blob/main/presets/catalog.community.json):
Spec Kit uses a dual-catalog system. For details about how catalogs work, see the main [Extensions README](README.md#extension-catalogs).
135
135
136
-
**For extension publishing**: All community extensions should be added to `catalog.community.json`. Users browse this catalog and copy extensions they trust into their own `catalog.json`.
136
+
**For extension publishing**: All community extensions are listed in `extensions/catalog.community.json`. Users browse this catalog and copy extensions they trust into their own `catalog.json`.
To submit your extension to the community catalog, file a new issue using the **[Extension Submission](https://github.com/github/spec-kit/issues/new?template=extension_submission.yml)** template. The template collects all required metadata, including:
148
141
149
-
### 2. Add Extension to Community Catalog
142
+
- Extension ID, name, and version
143
+
- Description, author, and license
144
+
- Repository, download URL, and documentation links
145
+
- Required Spec Kit version and any tool dependencies
146
+
- Number of commands and hooks
147
+
- Tags and key features
148
+
- Testing confirmation
150
149
151
-
Edit `extensions/catalog.community.json` and add your extension:
150
+
> [!IMPORTANT]
151
+
> Do **not** open a pull request directly to edit the catalog JSON. All community extension submissions must go through the issue template so a maintainer can review the metadata and update the catalog.
- Set `downloads: 0` and `stars: 0` (auto-updated later)
204
-
- Use current timestamp for `created_at` and `updated_at`
205
-
- Update the top-level `updated_at` to current time
206
-
207
-
### 3. Update Community Extensions Table
208
-
209
-
Add your extension to the Community Extensions table in the project root `README.md`:
210
-
211
-
```markdown
212
-
| Your Extension Name | Brief description of what it does | `<category>` | <effect> | [repo-name](https://github.com/your-org/spec-kit-your-extension) |
213
-
```
153
+
### What Happens After You Submit
214
154
215
-
**(Table) Category** — pick the one that best fits your extension:
155
+
1. Your issue is automatically labeled and assigned to a maintainer for review
156
+
2. A maintainer verifies that the metadata is complete and the download URL is accessible
157
+
3. Once approved, the maintainer adds your extension to `extensions/catalog.community.json` and the Community Extensions table in the README
158
+
4. Your extension becomes discoverable via `specify extension search`
216
159
217
-
-`docs` — reads, validates, or generates spec artifacts
218
-
-`code` — reviews, validates, or modifies source code
219
-
-`process` — orchestrates workflow across phases
220
-
-`integration` — syncs with external platforms
221
-
-`visibility` — reports on project health or progress
160
+
### Updating an Existing Extension
222
161
223
-
**Effect** — choose one:
224
-
225
-
- Read-only — produces reports without modifying files
226
-
- Read+Write — modifies files, creates artifacts, or updates specs
227
-
228
-
Insert your extension in alphabetical order in the table.
-[x] Added to Community Extensions table in README.md
277
-
278
-
### Testing
279
-
Tested on:
280
-
- macOS 13.0+ with spec-kit 0.1.0
281
-
- Project: [Your test project]
282
-
283
-
### Additional Notes
284
-
Any additional context or notes for reviewers.
285
-
```
162
+
To update an extension that is already in the catalog (e.g., for a new version), file a new **[Extension Submission](https://github.com/github/spec-kit/issues/new?template=extension_submission.yml)** issue with the updated version, download URL, and any other changed fields. Mention in the issue that this is an update to an existing entry.
Copy file name to clipboardExpand all lines: extensions/README.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,13 +25,13 @@ specify extension search # Now uses your organization's catalog instead of the
25
25
### Community Reference Catalog (`catalog.community.json`)
26
26
27
27
> [!NOTE]
28
-
> Community extensions are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the extension code itself**. Review extension source code before installation and use at your own discretion.
28
+
> Community extensions are independently created and maintained by their respective authors. Maintainers only verify that catalog entries are complete and correctly formatted — they do **not review, audit, endorse, or support the extension code itself**. Review extension source code before installation and use at your own discretion.
29
29
30
30
-**Purpose**: Browse available community-contributed extensions
31
31
-**Status**: Active - contains extensions submitted by the community
> Community extensions are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the extension code itself**. The Community Extensions website is also a third-party resource. Review extension source code before installation and use at your own discretion.
75
+
> Community extensions are independently created and maintained by their respective authors. Maintainers only verify that catalog entries are complete and correctly formatted — they do **not review, audit, endorse, or support the extension code itself**. The Community Extensions website is also a third-party resource. Review extension source code before installation and use at your own discretion.
76
76
77
77
🔍 **Browse and search community extensions on the [Community Extensions website](https://speckit-community.github.io/extensions/).**
78
78
@@ -89,10 +89,8 @@ To add your extension to the community catalog:
89
89
90
90
1.**Prepare your extension** following the [Extension Development Guide](EXTENSION-DEVELOPMENT-GUIDE.md)
91
91
2.**Create a GitHub release** for your extension
92
-
3.**Submit a Pull Request** that:
93
-
- Adds your extension to `extensions/catalog.community.json`
94
-
- Updates this README with your extension in the Available Extensions table
95
-
4.**Wait for review** - maintainers will review and merge if criteria are met
92
+
3.**File an issue** using the [Extension Submission](https://github.com/github/spec-kit/issues/new?template=extension_submission.yml) template with all required metadata
93
+
4.**Wait for review** — a maintainer will review the submission, update the catalog, and close the issue
96
94
97
95
See the [Extension Publishing Guide](EXTENSION-PUBLISHING-GUIDE.md) for detailed step-by-step instructions.
Copy file name to clipboardExpand all lines: presets/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,7 +98,7 @@ Multiple composing presets chain recursively. For example, a security preset wit
98
98
Presets are discovered through catalogs. By default, Spec Kit uses the official and community catalogs:
99
99
100
100
> [!NOTE]
101
-
> Community presets are independently created and maintained by their respective authors. GitHub and the Spec Kit maintainers may review pull requests that add entries to the community catalog for formatting, catalog structure, or policy compliance, but they do **not review, audit, endorse, or support the preset code itself**. Review preset source code before installation and use at your own discretion.
101
+
> Community presets are independently created and maintained by their respective authors. Maintainers only verify that catalog entries are complete and correctly formatted — they do **not review, audit, endorse, or support the preset code itself**. Review preset source code before installation and use at your own discretion.
0 commit comments