meta(index): Improve safe skill categorization

tools/scripts/tests/run-test-suite.js

@@ -23,6 +23,7 @@ const LOCAL_TEST_COMMANDS = [
   [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_fix_missing_skill_metadata.py")],
   [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_fix_missing_skill_sections.py")],
   [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_fix_truncated_descriptions.py")],
+  [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_generate_index_categories.py")],
   [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_sync_microsoft_skills_security.py")],
   [path.join(TOOL_SCRIPTS, "run-python.js"), path.join(TOOL_TESTS, "test_validate_skills_headings.py")],
 ];

tools/scripts/tests/test_generate_index_categories.py

@@ -0,0 +1,99 @@
+import importlib.util
+import pathlib
+import sys
+import tempfile
+import unittest
+
+
+REPO_ROOT = pathlib.Path(__file__).resolve().parents[3]
+sys.path.insert(0, str(REPO_ROOT / "tools" / "scripts"))
+
+
+def load_module(module_path: str, module_name: str):
+    spec = importlib.util.spec_from_file_location(module_name, REPO_ROOT / module_path)
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+generate_index = load_module("tools/scripts/generate_index.py", "generate_index_categories")
+
+
+class GenerateIndexCategoryTests(unittest.TestCase):
+    def test_infer_category_returns_none_for_weak_signal(self):
+        inferred = generate_index.infer_category(
+            "mystery-skill",
+            "Mystery Skill",
+            "General-purpose guidance for assorted tasks.",
+        )
+        self.assertIsNone(inferred)
+
+    def test_infer_category_detects_security_skill(self):
+        inferred = generate_index.infer_category(
+            "web-security-testing",
+            "Web Security Testing",
+            "Identify vulnerabilities, auth flaws, and threat scenarios for web applications.",
+        )
+        self.assertEqual(inferred, "security")
+
+    def test_infer_category_uses_family_prefix_when_high_confidence(self):
+        inferred = generate_index.infer_category(
+            "apify-market-research",
+            "Apify Market Research",
+            "Research markets using Apify actors.",
+        )
+        self.assertEqual(inferred, "automation")
+
+    def test_infer_category_maps_workflow_family_prefixes(self):
+        inferred = generate_index.infer_category(
+            "github-actions-templates",
+            "GitHub Actions Templates",
+            "Production-ready workflow patterns for GitHub automation.",
+        )
+        self.assertEqual(inferred, "workflow")
+
+    def test_infer_category_maps_development_family_prefixes(self):
+        inferred = generate_index.infer_category(
+            "javascript-mastery",
+            "JavaScript Mastery",
+            "Essential JavaScript concepts for developers.",
+        )
+        self.assertEqual(inferred, "development")
+
+    def test_generate_index_prefers_frontmatter_then_parent_then_inference(self):
+        with tempfile.TemporaryDirectory() as temp_dir:
+            base = pathlib.Path(temp_dir)
+            skills_dir = base / "skills"
+            output_file = base / "skills_index.json"
+
+            explicit_dir = skills_dir / "explicit-skill"
+            explicit_dir.mkdir(parents=True)
+            (explicit_dir / "SKILL.md").write_text(
+                "---\nname: explicit-skill\ncategory: custom\n---\nbody\n",
+                encoding="utf-8",
+            )
+
+            nested_dir = skills_dir / "bundles" / "nested-skill"
+            nested_dir.mkdir(parents=True)
+            (nested_dir / "SKILL.md").write_text(
+                "---\nname: nested-skill\ndescription: Example\n---\nbody\n",
+                encoding="utf-8",
+            )
+
+            inferred_dir = skills_dir / "playwright-skill"
+            inferred_dir.mkdir(parents=True)
+            (inferred_dir / "SKILL.md").write_text(
+                "---\nname: playwright-skill\ndescription: End-to-end test automation with Playwright and browser workflows.\n---\nbody\n",
+                encoding="utf-8",
+            )
+
+            skills = generate_index.generate_index(str(skills_dir), str(output_file))
+            categories = {skill["id"]: skill["category"] for skill in skills}
+
+            self.assertEqual(categories["explicit-skill"], "custom")
+            self.assertEqual(categories["nested-skill"], "bundles")
+            self.assertEqual(categories["playwright-skill"], "testing")
+
+
+if __name__ == "__main__":
+    unittest.main()