diff --git a/skills/integrations/grpc-dev/SKILL.md b/skills/integrations/grpc-dev/SKILL.md
index d0d103f62..009e5b819 100644
--- a/skills/integrations/grpc-dev/SKILL.md
+++ b/skills/integrations/grpc-dev/SKILL.md
@@ -1,8 +1,12 @@
-# Skill: grpc-dev
-
-**Activates when:** Working on gRPC streaming, AG-UI event flow, WatchSessionMessages, control plane ↔ runner protocol, or debugging gRPC connectivity.
-
 ---
+name: grpc-dev
+description: >
+  Use when working on gRPC streaming, AG-UI event flow,
+  WatchSessionMessages, the control-plane-to-runner protocol, or
+  debugging gRPC connectivity in Ambient.
+---
+
+# gRPC Development
 
 ## Architecture
 
diff --git a/skills/sessions/ambient-api-server/SKILL.md b/skills/sessions/ambient-api-server/SKILL.md
index 5765d2582..5849b314c 100644
--- a/skills/sessions/ambient-api-server/SKILL.md
+++ b/skills/sessions/ambient-api-server/SKILL.md
@@ -1,8 +1,12 @@
-# Skill: ambient-api-server
-
-**Activates when:** Working in `components/ambient-api-server/` or asked about API server, REST endpoints, gRPC, OpenAPI, or plugins.
-
 ---
+name: ambient-api-server
+description: >
+  Use when working in components/ambient-api-server/ or on the Ambient API
+  Server's REST endpoints, gRPC streams, OpenAPI generation, plugin resources,
+  auth, migrations, or tests.
+---
+
+# Ambient API Server
 
 ## What This Skill Knows