diff --git a/layers/marketing/app/pages/developers.vue b/layers/marketing/app/pages/developers.vue
index b29752ef..1805f445 100644
--- a/layers/marketing/app/pages/developers.vue
+++ b/layers/marketing/app/pages/developers.vue
@@ -229,7 +229,7 @@ const uiClass = 'font-medium text-default'
                   class="min-h-11 hover:bg-primary-600 active:bg-primary-700"
                 />
                 <p class="mt-5">
-                  Claude opens the <strong :class="uiClass">Add custom connector</strong> dialog with skilld filled in. Check the name and the server URL, then confirm. In a chat, open the <strong :class="uiClass">+</strong> menu, select <strong :class="uiClass">Connectors</strong>, and check that skilld is on.
+                  Claude opens the <strong :class="uiClass">Add custom connector</strong> dialog with skilld filled in. Select <strong :class="uiClass">Continue</strong>, keep <strong :class="uiClass">No sign-in</strong>, and select <strong :class="uiClass">Add</strong>. Then select <strong :class="uiClass">Connect</strong>. In a chat, open the <strong :class="uiClass">+</strong> menu, select <strong :class="uiClass">Connectors</strong>, and check that skilld is on.
                 </p>
                 <p class="mt-4">
                   Or open <a href="https://claude.ai/customize/connectors" target="_blank" rel="noopener" :class="uiClass" class="underline underline-offset-2">Customize &gt; Connectors</a> in claude.ai or the Claude desktop app. Select <strong :class="uiClass">Add custom connector</strong>, name it skilld, and paste the server URL.
diff --git a/layers/mcp/server/mcp/index.ts b/layers/mcp/server/mcp/index.ts
index 1b711813..303fdd4c 100644
--- a/layers/mcp/server/mcp/index.ts
+++ b/layers/mcp/server/mcp/index.ts
@@ -21,7 +21,8 @@ export default defineMcpHandler({
       title: tool.title,
       description: tool.description,
       inputSchema: tool.inputSchema,
-      annotations: tool.annotations,
+      // Claude's directory reads the title from the annotations as well.
+      annotations: { title: tool.title, ...tool.annotations },
       handler: (args, extra) => tool.run(deps, args, extra.signal),
     }))
   },
diff --git a/layers/mcp/shared/mcp-tools.ts b/layers/mcp/shared/mcp-tools.ts
index 2f525c2e..4b1e3802 100644
--- a/layers/mcp/shared/mcp-tools.ts
+++ b/layers/mcp/shared/mcp-tools.ts
@@ -135,7 +135,7 @@ const SearchArgs = z.object({
 const searchSkills: McpTool = {
   name: 'search_skills',
   title: 'Search Skills',
-  description: 'Search the skilld.dev registry for agent skills that match a topic. A skill is a SKILL.md file that a maintainer publishes in their own GitHub repository, and it works with any coding agent. Returns each match with its source repository, GitHub star count, skilld.dev page, and run command. get_skill returns the full provenance of one match.',
+  description: 'Search the skilld.dev registry for agent skills that match a topic. A skill is a SKILL.md file that a maintainer publishes in their own GitHub repository, and it works with any coding agent. Returns each match with its source repository, GitHub star count, skilld.dev page, and run command.',
   inputSchema: SearchArgs.shape,
   annotations: {
     readOnlyHint: true,