Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

docs: consolidate Community sections in README (#2736)

Manfred Riemad6235701508
diff --git a/README.md b/README.md
index 2c9f7dd0d..5b4a6c5d5 100644
--- a/README.md
+++ b/README.md
@@ -22,10 +22,7 @@
- [πŸ€” What is Spec-Driven Development?](#-what-is-spec-driven-development)
- [⚑ Get Started](#-get-started)
- [πŸ“½οΈ Video Overview](#️-video-overview)
-- [🧩 Community Extensions](#-community-extensions)
-- [🎨 Community Presets](#-community-presets)
-- [🚢 Community Walkthroughs](#-community-walkthroughs)
-- [πŸ› οΈ Community Friends](#️-community-friends)
+- [🌍 Community](#-community)
- [πŸ€– Supported AI Coding Agent Integrations](#-supported-ai-coding-agent-integrations)
- [πŸ”§ Specify CLI Reference](#-specify-cli-reference)
- [🧩 Making Spec Kit Your Own: Extensions & Presets](#-making-spec-kit-your-own-extensions--presets)
@@ -112,31 +109,19 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c
[![Spec Kit video header](/media/spec-kit-video-header.jpg)](https://www.youtube.com/watch?v=a9eR1xsfvHg&pp=0gcJCckJAYcqIYzv)
-## 🧩 Community Extensions
+## 🌍 Community
-Community-contributed extensions add new commands, hooks, and capabilities to Spec Kit. See the full list on the [Community Extensions](https://github.github.io/spec-kit/community/extensions.html) page.
+Explore community-contributed resources on the [Spec Kit docs site](https://github.github.io/spec-kit/):
-> [!NOTE]
-> 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.
-
-To submit your own extension, see the [Extension Publishing Guide](extensions/EXTENSION-PUBLISHING-GUIDE.md).
-
-## 🎨 Community Presets
-
-Community-contributed presets customize how Spec Kit behaves β€” overriding templates, commands, and terminology without changing any tooling. See the full list on the [Community Presets](https://github.github.io/spec-kit/community/presets.html) page.
+- [Extensions](https://github.github.io/spec-kit/community/extensions.html) β€” commands, hooks, and capabilities
+- [Presets](https://github.github.io/spec-kit/community/presets.html) β€” template and terminology overrides
+- [Walkthroughs](https://github.github.io/spec-kit/community/walkthroughs.html) β€” end-to-end SDD scenarios
+- [Friends](https://github.github.io/spec-kit/community/friends.html) β€” projects that extend or build on Spec Kit
> [!NOTE]
-> Community presets are third-party contributions and are not maintained by the Spec Kit team. Review them carefully before use, and see the docs page above for the full disclaimer.
-
-To submit your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).
-
-## 🚢 Community Walkthroughs
-
-See Spec-Driven Development in action across different scenarios with community-contributed walkthroughs; find the full list on the [Community Walkthroughs](https://github.github.io/spec-kit/community/walkthroughs.html) page.
-
-## πŸ› οΈ Community Friends
+> Community contributions are independently created and maintained by their respective authors. Review source code before installation and use at your own discretion.
-Community projects that extend, visualize, or build on Spec Kit. See the full list on the [Community Friends](https://github.github.io/spec-kit/community/friends.html) page.
+Want to contribute? See the [Extension Publishing Guide](extensions/EXTENSION-PUBLISHING-GUIDE.md) or the [Presets Publishing Guide](presets/PUBLISHING.md).
## πŸ€– Supported AI Coding Agent Integrations
@@ -206,7 +191,7 @@ specify extension add <extension-name>
For example, extensions could add Jira integration, post-implementation code review, V-Model test traceability, or project health diagnostics.
-See the [Extensions reference](https://github.github.io/spec-kit/reference/extensions.html) for the full command guide. Browse the [community extensions](#-community-extensions) above for what's available.
+See the [Extensions reference](https://github.github.io/spec-kit/reference/extensions.html) for the full command guide. Browse the [community extensions](https://github.github.io/spec-kit/community/extensions.html) for what's available.
### Presets β€” Customize Existing Workflows
diff --git a/extensions/README.md b/extensions/README.md
index 4dc9e64f5..ca39feedc 100644
--- a/extensions/README.md
+++ b/extensions/README.md
@@ -76,7 +76,7 @@ specify extension add <extension-name> --from https://github.com/org/spec-kit-ex
πŸ” **Browse and search community extensions on the [Community Extensions website](https://speckit-community.github.io/extensions/).**
-See the [Community Extensions](../README.md#-community-extensions) section in the main README for the full list of available community-contributed extensions.
+See the [Community Extensions](https://github.github.io/spec-kit/community/extensions.html) page for the full list of available community-contributed extensions.
For the raw catalog data, see [`catalog.community.json`](catalog.community.json).
diff --git a/src/specify_cli/integrations/hermes/__init__.py b/src/specify_cli/integrations/hermes/__init__.py
index 046de4368..f0ae6a6b7 100644
--- a/src/specify_cli/integrations/hermes/__init__.py
+++ b/src/specify_cli/integrations/hermes/__init__.py
@@ -172,6 +172,8 @@ class HermesIntegration(SkillsIntegration):
f"{processed_body}"
)
+ skill_content = self.post_process_skill_content(skill_content)
+
# Write directly to global ~/.hermes/skills/speckit-<name>/SKILL.md
skill_dir = global_skills_dir / skill_name
skill_dir.mkdir(parents=True, exist_ok=True)
diff --git a/tests/integrations/test_integration_hermes.py b/tests/integrations/test_integration_hermes.py
index f9171fb3f..6b05a4c79 100644
--- a/tests/integrations/test_integration_hermes.py
+++ b/tests/integrations/test_integration_hermes.py
@@ -197,6 +197,24 @@ class TestHermesIntegration(SkillsIntegrationTests):
"Foreign skill was removed by teardown"
)
+ def test_hook_sections_explain_dotted_command_conversion(self, tmp_path, monkeypatch):
+ """Override: Hermes skills live in global ~/.hermes/skills/."""
+ home = _fake_home(tmp_path)
+ monkeypatch.setattr(Path, "home", lambda: home)
+
+ i = get_integration(self.KEY)
+ m = IntegrationManifest(self.KEY, tmp_path)
+ i.setup(tmp_path, m)
+ specify_skill = home / ".hermes" / "skills" / "speckit-specify" / "SKILL.md"
+ assert specify_skill.exists()
+ content = specify_skill.read_text(encoding="utf-8")
+ assert "replace dots" in content, (
+ "speckit-specify should explain dotted hook command conversion"
+ )
+ assert content.count("replace dots") == content.count(
+ "- For each executable hook, output the following"
+ )
+
def test_complete_file_inventory_sh(self, tmp_path, monkeypatch):
"""Override: Hermes init produces no local SKILL.md files,
only the empty .hermes/skills/ marker."""