diff --git a/airbyte/mcp/cloud.py b/airbyte/mcp/cloud.py
index 39c1d41b0..3c6948723 100644
--- a/airbyte/mcp/cloud.py
+++ b/airbyte/mcp/cloud.py
@@ -132,11 +132,11 @@ def _manifest_yaml_source_hint() -> str | None:
 SKILL_DOCS_SECTION_HINT = """\
 Skill doc sections for direct API queries and actions are named with the pattern
 `actions.<entity_type>.<action>`, matching the `entity_type` and `action` arguments of the
-`execute_external_api_query` tool. Call `get_agent_skill_docs` with the deployed `connector_id`
-(or a `docs_skill_id`) and no `section` to get the overview and list of available sections, then
-retrieve the relevant section(s) before calling an action. E.g. for GitHub `entity_type='issues'`,
-`action='list'`, the `'actions.issues.list'` section will teach that its expected
-`api_args` keys are `owner`, `repo`, `states`, etc.\
+`execute_external_api_query` tool. Call `get_agent_skill_docs` with no `section` input to list all
+available sections, and/or retrieve the relevant section(s) with `get_agent_skill_docs` before
+calling an action. E.g. for GitHub `entity_type='issues'`, `action='list'`, the
+`'actions.issues.list'` section will teach that its expected `api_args` keys are `owner`,
+`repo`, `states`, etc.\
 """
 CONNECTOR_CHECK_FAILURE_FALLBACK = "Connector check failed without a failure message."
 DEFER_CREDENTIALS_TIP_TEXT = (
diff --git a/airbyte/mcp/guidance.py b/airbyte/mcp/guidance.py
index 28638f5cb..dbda460f3 100644
--- a/airbyte/mcp/guidance.py
+++ b/airbyte/mcp/guidance.py
@@ -193,8 +193,7 @@ def get_agent_skill_docs(
         str | None,
         Field(
             description=(
-                "ID of a source or destination deployed in the workspace (not a connector "
-                "definition ID); resolves that connector's skill docs. "
+                "Deployed source or destination ID; resolves that connector's skill docs. "
                 "Provide this or `docs_skill_id`."
             ),
             default=None,
@@ -220,17 +219,10 @@ def get_agent_skill_docs(
         TraceArg.OMIT,
     ],
 ) -> AgentSkillDocsResult:
-    """Read a deployed connector's direct-access docs (agent skill docs).
+    """Returns the requested skill document by ID for an AI agent.
 
-    These docs describe the entity types, actions, and arguments that
-    `execute_external_api_query` accepts for one deployed source or SQL passthrough
-    destination. They are not general Airbyte guidance; for questions about Airbyte
-    itself (setting up connections, sync modes, connector setup), use
-    `search_airbyte_knowledge_sources` instead.
-
-    Exactly one of `connector_id` or `docs_skill_id` is required. `connector_id` must be
-    the ID of a source or destination deployed in the workspace (for example from
-    `list_cloud_connectors`), not a connector definition ID from the registry.
+    Pass either a fully-qualified `docs_skill_id` or a `connector_id` (source or
+    destination); exactly one is required.
     """
     workspace: CloudWorkspace = _get_cloud_workspace(ctx, workspace_id)
     return render_agent_skill_docs_result(