docs: Add Skill Registry Python SDK section in README

PiperOrigin-RevId: 915047314

Author: vertex-sdk-bot

README.rst

@@ -291,6 +291,79 @@ The following uses a utility function available on Prompt objects to transform a
         contents=retrieved_prompt.assemble_contents(),
     )
 
+Skill Registry
+^^^^^^^^^^^^^^
+
+Create and manage skills in Skill Registry. You can optionally specify a custom string identifier using the `skill_id` configuration parameter.
+
+.. code-block:: Python
+
+    # Create a skill
+    skill = client.skills.create(
+        display_name="weather_skill",
+        description="Retrieves the weather for a given location",
+        config={
+            "local_path": "./weather_skill_dir",
+            "skill_id": "my-custom-weather-skill",
+        },
+    )
+
+Get an existing skill by its resource name.
+
+.. code-block:: Python
+
+    fetched_skill = client.skills.get(name=skill.name)
+
+Update an existing skill's metadata or underlying implementation.
+
+.. code-block:: Python
+
+    # Update skill metadata
+    updated_skill = client.skills.update(
+        name=skill.name,
+        config={
+            "display_name": "Updated Weather Skill",
+            "description": "Provides localized current weather conditions and multi-day forecasts.",
+        },
+    )
+
+List all registered skills.
+
+.. code-block:: Python
+
+    # List skills with custom page size
+    pager = client.skills.list(config={"page_size": 10})
+    for item in pager:
+        print(item.name, item.display_name)
+
+Search for skills semantically matched to a query.
+
+.. code-block:: Python
+
+    # Retrieve skills matched to a semantic query
+    matched_skills = client.skills.retrieve(query="weather forecast")
+
+List and view revisions for a skill using the `ListSkillRevisions` and `GetSkillRevision` API methods.
+
+.. code-block:: Python
+
+    # List skill revisions
+    revisions_response = client.skills.revisions.list(name=skill.name)
+    for rev in revisions_response.skill_revisions:
+        print(rev.name, rev.create_time)
+
+    # Get a specific skill revision by its resource name
+    if revisions_response.skill_revisions:
+        target_revision_name = revisions_response.skill_revisions[0].name
+        revision = client.skills.revisions.get(name=target_revision_name)
+
+Delete a skill when it is no longer required.
+
+.. code-block:: Python
+
+    # Delete a skill
+    client.skills.delete(name=skill.name)
+
 -----------------------------------------
 
 .. note::

gemini_docs/vertexai/vertexai.rst

@@ -18,6 +18,7 @@ Vertex AI SDK
     .. autoattribute:: agent_engines
     .. autoattribute:: prompt_optimizer
     .. autoattribute:: prompts
+    .. autoattribute:: skills
 
 .. automodule:: vertexai._genai.evals
     :members:
@@ -88,6 +89,22 @@ Vertex AI SDK
         :undoc-members:
         :show-inheritance:
 
+.. automodule:: vertexai._genai.skills
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+    .. autoclass:: vertexai._genai.skills.Skills
+        :members:
+        .. autoattribute:: revisions
+
+    Revisions
+    ---------
+    .. automodule:: vertexai._genai.skill_revisions
+        :members:
+        :undoc-members:
+        :show-inheritance:
+
 .. automodule:: vertexai._genai.types
     :members:
     :undoc-members: