Skip to content

Add toc-navigation community preset to catalog and README #2080

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

Merged
mnriem merged 16 commits into from
Apr 7, 2026
+25 −0
Merged

Add toc-navigation community preset to catalog and README #2080

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
840f042
feat: add Table of Contents to generated markdown documents (#1970)
Quratulain-bilal Apr 3, 2026
07068d8
fix: address Copilot review - clarify TOC placement wording
Quratulain-bilal Apr 3, 2026
24db1ad
fix: include TOC sections in structure templates
Quratulain-bilal Apr 3, 2026
2d447ac
fix: include TOC in structure templates and fix tasks TOC placement w…
Quratulain-bilal Apr 3, 2026
d40556e
fix: correct TOC anchors to match headings with mandatory suffix
Quratulain-bilal Apr 3, 2026
4189f18
fix: include all ##-level headings in tasks-template TOC
Quratulain-bilal Apr 3, 2026
10b792c
fix: add missing TOC entries in tasks-template, remove leading blank …
Quratulain-bilal Apr 3, 2026
a50a4f1
fix: move TOC after metadata block and include all ## headings in tas…
Quratulain-bilal Apr 3, 2026
8fe5b42
fix: use plain text for dynamic phase entries in tasks-template TOC
Quratulain-bilal Apr 3, 2026
06963de
fix: remove hardcoded anchor links from template TOCs, use plain text…
Quratulain-bilal Apr 3, 2026
1543cde
fix: remove HTML comments from template TOCs
Quratulain-bilal Apr 3, 2026
1c6792d
fix: add missing Parallel Example heading to tasks-template TOC
Quratulain-bilal Apr 3, 2026
760d638
revert: remove all core template changes, pivot to preset approach
Quratulain-bilal Apr 3, 2026
f546632
feat: deliver TOC navigation as a preset (closes #1970)
Quratulain-bilal Apr 4, 2026
00187d9
feat: publish toc-navigation preset to community catalog (#1970)
Quratulain-bilal Apr 6, 2026
263e5ae
Add toc-navigation preset to main README community presets table
Quratulain-bilal Apr 7, 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
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -244,6 +244,7 @@ The following community-contributed presets customize how Spec Kit behaves — o
| AIDE In-Place Migration | Adapts the AIDE extension workflow for in-place technology migrations (X → Y pattern) — adds migration objectives, verification gates, knowledge documents, and behavioral equivalence criteria | 2 templates, 8 commands | AIDE extension | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
| Canon Core | Adapts original Spec Kit workflow to work together with Canon extension | 2 templates, 8 commands | — | [spec-kit-canon](https://github.com/maximiliamus/spec-kit-canon) |
| Pirate Speak (Full) | Transforms all Spec Kit output into pirate speak — specs become "Voyage Manifests", plans become "Battle Plans", tasks become "Crew Assignments" | 6 templates, 9 commands | — | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
| Table of Contents Navigation | Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents | 3 templates, 3 commands | — | [spec-kit-preset-toc-navigation](https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation) |
| VS Code Ask Questions | Enhances the clarify command to use `vscode/askQuestions` for batched interactive questioning. | 1 command | — | [spec-kit-presets](https://github.com/fdcastel/spec-kit-presets) |
Comment thread
mnriem marked this conversation as resolved.
Comment thread
mnriem marked this conversation as resolved.

To build and publish your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).
Expand Down
24 changes: 24 additions & 0 deletions presets/catalog.community.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,30 @@
"experimental"
]
},
"toc-navigation": {
"name": "Table of Contents Navigation",
"id": "toc-navigation",
"version": "1.0.0",
"description": "Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents",
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

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

Minor consistency: other preset descriptions in this file end with a period, but this new description does not. Consider adding the trailing period to match the surrounding entries.

Suggested change
"description": "Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents",
"description": "Adds a navigable Table of Contents to generated spec.md, plan.md, and tasks.md documents.",

Copilot uses AI. Check for mistakes.
"author": "Quratulain-bilal",
"repository": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation",
"download_url": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation/archive/refs/tags/v1.0.0.zip",
"homepage": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation",
"documentation": "https://github.com/Quratulain-bilal/spec-kit-preset-toc-navigation/blob/main/README.md",
"license": "MIT",
"requires": {
"speckit_version": ">=0.4.0"
},
"provides": {
Comment on lines +81 to +95
Copy link

Copilot AI Apr 7, 2026

Choose a reason for hiding this comment

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

The preset catalog entry is missing the per-preset created_at and updated_at fields shown in the Preset Publishing Guide’s recommended catalog.community.json format. Adding those timestamps (and bumping the top-level catalog updated_at to reflect this change) would keep the catalog metadata consistent and make updates easier to track over time.

Copilot uses AI. Check for mistakes.
"templates": 3,
"commands": 3
},
"tags": [
"navigation",
"toc",
"documentation"
]
},
"vscode-ask-questions": {
"name": "VS Code Ask Questions",
"id": "vscode-ask-questions",
Expand Down
Loading