Skip to content

docs: update publishing guide with Category and Effect columns #1913

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
imviancagrace wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: update publishing guide with Category and Effect columns #1913

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5254efe
docs: update publishing guide with Category and Effect columns
imviancagrace Mar 19, 2026
8b3a2e2
docs: copilot comments
imviancagrace Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion extensions/EXTENSION-PUBLISHING-GUIDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,9 +209,22 @@ Edit `extensions/catalog.community.json` and add your extension:
Add your extension to the Available Extensions table in `extensions/README.md`:

```markdown
| Your Extension Name | Brief description of what it does | [repo-name](https://github.com/your-org/spec-kit-your-extension) |
| Your Extension Name | Brief description of what it does | `<category>` | <effect> | [repo-name](https://github.com/your-org/spec-kit-your-extension) |
```
Comment on lines 211 to 213
Copy link

Copilot AI Mar 19, 2026

Choose a reason for hiding this comment

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

The example row here includes Category and Effect columns, but the current extensions/README.md “Available Community Extensions” table still has three columns (Extension | Purpose | URL). This guide should match the actual README table format, or the README needs to be updated in the same PR/rebased onto the change that adds those columns, otherwise extension authors will be told to submit a row that won’t fit the table.

This issue also appears on line 212 of the same file.

Copilot uses AI. Check for mistakes.

**(Table) Category** — pick the one that best fits your extension:

- `docs` — reads, validates, or generates spec artifacts
- `code` — reviews, validates, or modifies source code
- `process` — orchestrates workflow across phases
- `integration` — syncs with external platforms
- `visibility` — reports on project health or progress

**Effect** — choose one:

- Read-only — produces reports without modifying files
- Read+Write — modifies files, creates artifacts, or updates specs

Insert your extension in alphabetical order in the table.

### 4. Submit Pull Request
Expand Down
Loading