Mcp server doc updates

modules/ROOT/pages/common/nav-mcp-server.adoc

@@ -8,8 +8,8 @@
 ThoughtSpot Spotter MCP Server
 
 * link:{{navprefix}}/mcp-integration[Overview]
-** link:{{navprefix}}/mcp-server-spotter3[MCP Server with Spotter 3]
-** link:{{navprefix}}/mcp-server-legacy[Legacy MCP Server architecture and tools]
+* link:{{navprefix}}/mcp-server-spotter3[MCP Server with Spotter 3]
+* link:{{navprefix}}/mcp-server-legacy[Legacy MCP Server architecture and tools]
 * link:{{navprefix}}/connect-mcp-server-to-clients[Connecting MCP Server to clients]
 * link:{{navprefix}}/custom-chatbot-integration-mcp[Integrating MCP Server in a custom app]
 

modules/ROOT/pages/mcp-server-client-connection.adoc

@@ -124,7 +124,6 @@ OAuth clients can be registered in one of the following ways:
 +
 To register a client, visit link:https://agent.thoughtspot.app/clients[ThoughtSpot MCP OAuth Client Registration, window=_blank]. When registering the OAuth client, add your ThoughtSpot instance URL to the appropriate field. This ensures that users are not prompted to enter the instance URL during the OAuth flow, and the OAuth redirect returns correctly to your ThoughtSpot environment after login.
 
-
 == Verifying integration
 After the MCP Server is connected, some clients show *ThoughtSpot Data Sources* under a *Resources* or *Datasets* section.
 
@@ -134,6 +133,40 @@ To verify the integration:
 . Verify that MCP tools are being called to generate responses. See the xref:mcp-tool-reference-guide.adoc[MCP tool reference guide] for information about tool calls.
 . Try the Liveboard creation request and verify whether a Liveboard is added to your ThoughtSpot application.
 
+== Using the ThoughtSpot skill with skill-aware clients
+Some LLM clients, such as Claude, support skills—packaged sets of instructions and best practices that an agent can load on demand to perform specific tasks more reliably.
+Alongside the ThoughtSpot Spotter MCP Server, ThoughtSpot provides a companion skill that helps skill-aware clients use the MCP tools more effectively. For example, routing questions intelligently, streaming its thinking as it works, and surfacing ThoughtSpot's own visualizations instead of generating charts.
+
+[NOTE]
+====
+The skill is installed separately from the connector. Connecting the ThoughtSpot Spotter connector (or configuring the MCP server) gives your client access to the available tools. Installing the skill doesn't provide the tools themselves; instead, it helps the client understand when and how to orchestrate those tools effectively. You can use the MCP server without the skill, but clients that support skills generally produce better results when both the connector and the skill are installed.
+====
+
+=== Before you begin
+
+* Connect the ThoughtSpot Spotter MCP Server to your client.
+See xref:mcp-server-client-connection.adoc#_using_thoughtspot_spotter_with_chatgpt_and_claude[Using ThoughtSpot Spotter with ChatGPT and Claude] and the connection sections above.
+* Confirm your client supports skills.
+Clients without skill support can still use the MCP Server directly; the skill is an enhancement, not a requirement.
+
+=== Adding the skill
+
+. Get the ThoughtSpot skill (`analyzing-data-with-thoughtspot`) from the link:https://github.com/thoughtspot/mcp-server/tree/main/skills[ThoughtSpot MCP Server repository, window=_blank].
+. Add the skill in your client, following the client's documentation for installing and enabling skills.
+. Confirm the skill is enabled and loaded in your client.
+
+=== Verifying the skill
+
+. Start a chat session with the agent and ask a data question.
+. Verify that the ThoughtSpot MCP tools are being called to generate the response.
+See the xref:mcp-tool-reference-guide.adoc[MCP tool reference guide] for information about tool calls.
+. Confirm the skill is influencing behavior. For example, more accurate data-context selection, cleaner chart generation, and successful Liveboard creation from the conversation.
+
+[NOTE]
+====
+Skill availability and installation steps may vary by client. Refer to your client's documentation for instructions on adding and managing skills.
+====
+
 == Troubleshooting errors
 
 MCP Server is not connected::

src/assets/styles/index.scss

@@ -1100,6 +1100,31 @@ a.anchor {
         background-position: -136px -68px;
     }
 }
+
+#wrapper[data-theme='dark'],
+#docsModal[data-theme='dark'] {
+    .typedoc-Type_alias a,
+    .typedoc-Function a {
+        color: #71a1f4;
+    }
+    .typedoc-Type_alias :before,
+    .typedoc-Function :before {
+        background-image: none;
+        background-color: #71a1f4;
+        -webkit-mask-repeat: no-repeat;
+        mask-repeat: no-repeat;
+        -webkit-mask-image: url(../icons/icons.png);
+        mask-image: url(../icons/icons.png);
+    }
+    .typedoc-Type_alias :before {
+        -webkit-mask-position: 0px -170px;
+        mask-position: 0px -170px;
+    }
+    .typedoc-Function :before {
+        -webkit-mask-position: -136px -68px;
+        mask-position: -136px -68px;
+    }
+}
 .header-banner {
     min-height: 240px;
     background: var(--header-banner-background);