refactor(server): canonicalize service API (#31049)

packages/server/src/groups/skill.ts

@@ -0,0 +1,28 @@
+import { SkillV2 } from "@opencode-ai/core/skill"
+import { Location } from "@opencode-ai/core/location"
+import { Schema } from "effect"
+import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi"
+import { LocationQuery, locationQueryOpenApi, LocationMiddleware } from "./location"
+
+export const SkillGroup = HttpApiGroup.make("server.skill")
+  .add(
+    HttpApiEndpoint.get("skill.list", "/api/skill", {
+      query: LocationQuery,
+      success: Location.response(Schema.Array(SkillV2.Info)),
+    })
+      .annotateMerge(locationQueryOpenApi)
+      .annotateMerge(
+        OpenApi.annotations({
+          identifier: "v2.skill.list",
+          summary: "List skills",
+          description: "Retrieve currently registered skills.",
+        }),
+      ),
+  )
+  .annotateMerge(
+    OpenApi.annotations({
+      title: "skills",
+      description: "Experimental skill routes.",
+    }),
+  )
+  .middleware(LocationMiddleware)