π« 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.mdindex 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[](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 Workflowsdiff --git a/extensions/README.md b/extensions/README.mdindex 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__.pyindex 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.mdskill_dir = global_skills_dir / skill_nameskill_dir.mkdir(parents=True, exist_ok=True)diff --git a/tests/integrations/test_integration_hermes.py b/tests/integrations/test_integration_hermes.pyindex 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."""