Skip to content

Commit b19a7ee

Browse files
authored
feat: add superpowers bridge extension to community catalog (#2023)
* docs: correct specify extension add syntax to require extension name The specify extension add command requires the extension name as a positional argument. Many documentation files incorrectly demonstrated using the --from flag without specifying the extension name first. * feat: add superb extension to community catalog Orchestrates obra/superpowers skills within the spec-kit SDD workflow. * fix: link superb extension docs
1 parent 9cb3f3d commit b19a7ee

File tree

7 files changed

+62
-18
lines changed

7 files changed

+62
-18
lines changed

.github/ISSUE_TEMPLATE/extension_submission.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ body:
1212
- Review the [Extension Publishing Guide](https://github.com/github/spec-kit/blob/main/extensions/EXTENSION-PUBLISHING-GUIDE.md)
1313
- Ensure your extension has a valid `extension.yml` manifest
1414
- Create a GitHub release with a version tag (e.g., v1.0.0)
15-
- Test installation: `specify extension add --from <your-release-url>`
15+
- Test installation: `specify extension add <extension-name> --from <your-release-url>`
1616
1717
- type: input
1818
id: extension-id
@@ -229,7 +229,7 @@ body:
229229
placeholder: |
230230
```bash
231231
# Install extension
232-
specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip
232+
specify extension add <extension-name> --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip
233233
234234
# Use a command
235235
/speckit.your-extension.command-name arg1 arg2

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,7 @@ The following community-contributed extensions are available in [`catalog.commun
208208
| Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | `docs` | Read+Write | [spec-kit-retrospective](https://github.com/emi-dm/spec-kit-retrospective) |
209209
| Review Extension | Post-implementation comprehensive code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification | `code` | Read-only | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) |
210210
| SDD Utilities | Resume interrupted workflows, validate project health, and verify spec-to-task traceability | `process` | Read+Write | [speckit-utils](https://github.com/mvanhorn/speckit-utils) |
211+
| Superpowers Bridge | Orchestrates obra/superpowers skills within the spec-kit SDD workflow across the full lifecycle (clarification, TDD, review, verification, critique, debugging, branch completion) | `process` | Read+Write | [superpowers-bridge](https://github.com/RbBtSn0w/spec-kit-extensions/tree/main/superpowers-bridge) |
211212
| Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | `docs` | Read+Write | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) |
212213
| Understanding | Automated requirements quality analysis — 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | `docs` | Read-only | [understanding](https://github.com/Testimonial/understanding) |
213214
| V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | `docs` | Read+Write | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) |

extensions/EXTENSION-DEVELOPMENT-GUIDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -514,7 +514,7 @@ zip -r spec-kit-my-ext-1.0.0.zip extension.yml commands/ scripts/ docs/
514514
Users install with:
515515

516516
```bash
517-
specify extension add --from https://github.com/.../spec-kit-my-ext-1.0.0.zip
517+
specify extension add <extension-name> --from https://github.com/.../spec-kit-my-ext-1.0.0.zip
518518
```
519519

520520
### Option 3: Community Reference Catalog

extensions/EXTENSION-PUBLISHING-GUIDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ Test that users can install from your release:
122122
specify extension add --dev /path/to/your-extension
123123
124124
# Test from GitHub archive
125-
specify extension add --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip
125+
specify extension add <extension-name> --from https://github.com/your-org/spec-kit-your-extension/archive/refs/tags/v1.0.0.zip
126126
```
127127

128128
---

extensions/EXTENSION-USER-GUIDE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -160,7 +160,7 @@ This will:
160160

161161
```bash
162162
# From GitHub release
163-
specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip
163+
specify extension add <extension-name> --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip
164164
```
165165

166166
### Install from Local Directory (Development)
@@ -737,7 +737,7 @@ You can still install extensions not in your catalog using `--from`:
737737
specify extension add jira
738738
739739
# Direct URL (bypasses catalog)
740-
specify extension add --from https://github.com/someone/spec-kit-ext/archive/v1.0.0.zip
740+
specify extension add <extension-name> --from https://github.com/someone/spec-kit-ext/archive/v1.0.0.zip
741741
742742
# Local development
743743
specify extension add --dev /path/to/extension
@@ -807,7 +807,7 @@ specify extension add --dev /path/to/extension
807807
2. Install older version of extension:
808808

809809
```bash
810-
specify extension add --from https://github.com/org/ext/archive/v1.0.0.zip
810+
specify extension add <extension-name> --from https://github.com/org/ext/archive/v1.0.0.zip
811811
```
812812

813813
### MCP Tool Not Available

extensions/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Populate your `catalog.json` with approved extensions:
5959
Skip catalog curation - team members install directly using URLs:
6060

6161
```bash
62-
specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip
62+
specify extension add <extension-name> --from https://github.com/org/spec-kit-ext/archive/refs/tags/v1.0.0.zip
6363
```
6464

6565
**Benefits**: Quick for one-off testing or private extensions
@@ -108,7 +108,7 @@ specify extension search # See what's in your catalog
108108
specify extension add <extension-name> # Install by name
109109

110110
# Direct from URL (bypasses catalog)
111-
specify extension add --from https://github.com/<org>/<repo>/archive/refs/tags/<version>.zip
111+
specify extension add <extension-name> --from https://github.com/<org>/<repo>/archive/refs/tags/<version>.zip
112112

113113
# List installed extensions
114114
specify extension list

extensions/catalog.community.json

Lines changed: 52 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
{
22
"schema_version": "1.0",
3-
"updated_at": "2026-03-28T00:00:00Z",
3+
"updated_at": "2026-03-30T00:00:00Z",
44
"catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json",
55
"extensions": {
66
"aide": {
77
"name": "AI-Driven Engineering (AIDE)",
88
"id": "aide",
9-
"description": "A structured 7-step workflow for building new projects from scratch with AI assistants \u2014 from vision through implementation.",
9+
"description": "A structured 7-step workflow for building new projects from scratch with AI assistants from vision through implementation.",
1010
"author": "mnriem",
1111
"version": "1.0.0",
1212
"download_url": "https://github.com/mnriem/spec-kit-extensions/releases/download/aide-v1.0.0/aide.zip",
@@ -170,7 +170,7 @@
170170
"cognitive-squad": {
171171
"name": "Cognitive Squad",
172172
"id": "cognitive-squad",
173-
"description": "Multi-agent cognitive system with Triadic Model: understanding, internalization, application \u2014 with quality gates, backpropagation verification, and self-healing",
173+
"description": "Multi-agent cognitive system with Triadic Model: understanding, internalization, application with quality gates, backpropagation verification, and self-healing",
174174
"author": "Testimonial",
175175
"version": "0.1.0",
176176
"download_url": "https://github.com/Testimonial/cognitive-squad/archive/refs/tags/v0.1.0.zip",
@@ -242,7 +242,7 @@
242242
"updated_at": "2026-03-19T12:08:20Z"
243243
},
244244
"docguard": {
245-
"name": "DocGuard \u2014 CDD Enforcement",
245+
"name": "DocGuard CDD Enforcement",
246246
"id": "docguard",
247247
"description": "Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero NPM runtime dependencies.",
248248
"author": "raccioly",
@@ -379,7 +379,7 @@
379379
"iterate": {
380380
"name": "Iterate",
381381
"id": "iterate",
382-
"description": "Iterate on spec documents with a two-phase define-and-apply workflow \u2014 refine specs mid-implementation and go straight back to building",
382+
"description": "Iterate on spec documents with a two-phase define-and-apply workflow refine specs mid-implementation and go straight back to building",
383383
"author": "Vianca Martinez",
384384
"version": "2.0.0",
385385
"download_url": "https://github.com/imviancagrace/spec-kit-iterate/archive/refs/tags/v2.0.0.zip",
@@ -469,9 +469,9 @@
469469
"updated_at": "2026-03-17T00:00:00Z"
470470
},
471471
"maqa": {
472-
"name": "MAQA \u2014 Multi-Agent & Quality Assurance",
472+
"name": "MAQA Multi-Agent & Quality Assurance",
473473
"id": "maqa",
474-
"description": "Coordinator \u2192 feature \u2192 QA agent workflow with parallel worktree-based implementation. Language-agnostic. Auto-detects installed board plugins (Trello, Linear, GitHub Projects, Jira, Azure DevOps). Optional CI gate.",
474+
"description": "Coordinator feature QA agent workflow with parallel worktree-based implementation. Language-agnostic. Auto-detects installed board plugins (Trello, Linear, GitHub Projects, Jira, Azure DevOps). Optional CI gate.",
475475
"author": "GenieRobot",
476476
"version": "0.1.3",
477477
"download_url": "https://github.com/GenieRobot/spec-kit-maqa-ext/releases/download/maqa-v0.1.3/maqa.zip",
@@ -994,7 +994,7 @@
994994
"status": {
995995
"name": "Project Status",
996996
"id": "status",
997-
"description": "Show current SDD workflow progress \u2014 active feature, artifact status, task completion, workflow phase, and extensions summary.",
997+
"description": "Show current SDD workflow progress active feature, artifact status, task completion, workflow phase, and extensions summary.",
998998
"author": "KhawarHabibKhan",
999999
"version": "1.0.0",
10001000
"download_url": "https://github.com/KhawarHabibKhan/spec-kit-status/archive/refs/tags/v1.0.0.zip",
@@ -1023,6 +1023,49 @@
10231023
"created_at": "2026-03-16T00:00:00Z",
10241024
"updated_at": "2026-03-16T00:00:00Z"
10251025
},
1026+
"superb": {
1027+
"name": "Superpowers Bridge",
1028+
"id": "superb",
1029+
"description": "Orchestrates obra/superpowers skills within the spec-kit SDD workflow. Thin bridge commands delegate to superpowers' authoritative SKILL.md files at runtime (with graceful fallback), while bridge-original commands provide spec-kit-native value. Eight commands cover the full lifecycle: intent clarification, TDD enforcement, task review, verification, critique, systematic debugging, branch completion, and review response. Hook-bound commands fire automatically; standalone commands are invoked when needed.",
1030+
"author": "rbbtsn0w",
1031+
"version": "1.0.0",
1032+
"download_url": "https://github.com/RbBtSn0w/spec-kit-extensions/releases/download/superpowers-bridge-v1.0.0/superpowers-bridge.zip",
1033+
"repository": "https://github.com/RbBtSn0w/spec-kit-extensions",
1034+
"homepage": "https://github.com/RbBtSn0w/spec-kit-extensions",
1035+
"documentation": "https://github.com/RbBtSn0w/spec-kit-extensions/blob/main/superpowers-bridge/README.md",
1036+
"changelog": "https://github.com/RbBtSn0w/spec-kit-extensions/blob/main/superpowers-bridge/CHANGELOG.md",
1037+
"license": "MIT",
1038+
"requires": {
1039+
"speckit_version": ">=0.4.3",
1040+
"tools": [
1041+
{
1042+
"name": "superpowers",
1043+
"version": ">=5.0.0",
1044+
"required": false
1045+
}
1046+
]
1047+
},
1048+
"provides": {
1049+
"commands": 8,
1050+
"hooks": 4
1051+
},
1052+
"tags": [
1053+
"methodology",
1054+
"tdd",
1055+
"code-review",
1056+
"workflow",
1057+
"superpowers",
1058+
"brainstorming",
1059+
"verification",
1060+
"debugging",
1061+
"branch-management"
1062+
],
1063+
"verified": false,
1064+
"downloads": 0,
1065+
"stars": 0,
1066+
"created_at": "2026-03-30T00:00:00Z",
1067+
"updated_at": "2026-03-30T00:00:00Z"
1068+
},
10261069
"sync": {
10271070
"name": "Spec Sync",
10281071
"id": "sync",
@@ -1058,7 +1101,7 @@
10581101
"understanding": {
10591102
"name": "Understanding",
10601103
"id": "understanding",
1061-
"description": "Automated requirements quality analysis \u2014 validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.",
1104+
"description": "Automated requirements quality analysis validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.",
10621105
"author": "Ladislav Bihari",
10631106
"version": "3.4.0",
10641107
"download_url": "https://github.com/Testimonial/understanding/archive/refs/tags/v3.4.0.zip",

0 commit comments

Comments
 (0)