feat: Implement ListSkills and DeleteSkill methods in Vertex AI GenAI SDK

PiperOrigin-RevId: 911346796

Author: vertex-sdk-bot

tests/unit/vertexai/genai/replays/test_skills_create.py

@@ -0,0 +1,80 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+"""Tests the skills.create() method against the Vertex AI endpoint using replays."""
+
+import io
+import os
+import tempfile
+import zipfile
+
+from tests.unit.vertexai.genai.replays import pytest_helper
+from vertexai._genai import types
+
+# MANDATORY: Initialize the replay test framework for this module
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+)
+
+
+def test_create_skill(client):
+  """Tests the creation of a skill using `client.skills.create()`."""
+  # Target the autopush sandbox endpoint for the Skill Registry API
+  client._api_client._http_options.base_url = (
+      "https://us-central1-autopush-aiplatform.sandbox.googleapis.com"
+  )
+
+  with tempfile.TemporaryDirectory() as tmpdir:
+    # Create a dummy skill structure (SKILL.md is required by the spec)
+    with open(os.path.join(tmpdir, "SKILL.md"), "w") as f:
+      f.write("# My Replay Skill\nThis is a test skill for replay tests.")
+
+    skill = client.skills.create(
+        display_name="My Replay Skill",
+        description="My Replay Skill Description",
+        config=types.CreateSkillConfig(
+            local_path=tmpdir, wait_for_completion=True
+        ),
+    )
+
+    assert skill.name is not None
+    assert skill.display_name == "My Replay Skill"
+    assert skill.description == "My Replay Skill Description"
+
+
+def test_create_skill_with_prezipped_bytes(client):
+  """Tests the creation of a skill with pre-zipped bytes."""
+  # Target the autopush sandbox endpoint for the Skill Registry API
+  client._api_client._http_options.base_url = (
+      "https://us-central1-autopush-aiplatform.sandbox.googleapis.com"
+  )
+
+  zip_buffer = io.BytesIO()
+  zinfo = zipfile.ZipInfo("SKILL.md", date_time=(1980, 1, 1, 0, 0, 0))
+  with zipfile.ZipFile(zip_buffer, "w") as zip_file:
+    zip_file.writestr(zinfo, "# My Zipped Replay Skill\nThis is a test.")
+  zipped_bytes = zip_buffer.getvalue()
+
+  skill = client.skills.create(
+      display_name="My Zipped Replay Skill",
+      description="My Zipped Replay Skill Description",
+      config=types.CreateSkillConfig(
+          zipped_filesystem=zipped_bytes, wait_for_completion=True
+      ),
+  )
+
+  assert skill.name is not None
+  assert skill.display_name == "My Zipped Replay Skill"
+  assert skill.description == "My Zipped Replay Skill Description"

tests/unit/vertexai/genai/replays/test_skills_get.py

@@ -0,0 +1,33 @@
+"""Tests the skills.get() method against the autopush endpoint."""
+
+from google.api_core import exceptions
+from tests.unit.vertexai.genai.replays import pytest_helper
+import pytest
+
+PROJECT_ID = "demo-project"
+REGION = "us-central1"
+SKILL_ID = "7184367305562783744"
+# target the autopush sandbox endpoint for the Skill Registry API
+ENDPOINT = f"{REGION}-autopush-aiplatform.sandbox.googleapis.com"
+
+
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+)
+
+
+def test_get_skill(client):  # client fixture is injected by pytest_helper.setup
+  """Tests the skills.get() method against the autopush endpoint."""
+
+  client._api_client._http_options.base_url = (
+      "https://us-central1-autopush-aiplatform.sandbox.googleapis.com"
+  )
+  skill_name = f"projects/{PROJECT_ID}/locations/{REGION}/skills/{SKILL_ID}"
+
+  try:
+    skill = client.skills.get(name=skill_name)
+    assert skill.name == skill_name
+
+  except exceptions.GoogleAPIError as e:
+    pytest.fail(f"Error calling client.skills.get(): {e}")

tests/unit/vertexai/genai/replays/test_skills_update.py

@@ -0,0 +1,113 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+"""Tests the skills.update() method against the Vertex AI endpoint using replays."""
+
+import io
+import os
+import random
+import tempfile
+import zipfile
+
+from tests.unit.vertexai.genai.replays import pytest_helper
+from vertexai._genai import types
+
+# MANDATORY: Initialize the replay test framework for this module
+pytestmark = pytest_helper.setup(
+    file=__file__,
+    globals_for_file=globals(),
+)
+
+PROJECT_ID = os.environ.get("GOOGLE_CLOUD_PROJECT", "srbai-testing")
+REGION = "us-central1"
+
+
+def test_update_skill(client):
+  """Tests the update of a skill using `client.skills.update()` (metadata only)."""
+  # Target the autopush sandbox endpoint for the Skill Registry API
+  client._api_client._http_options.base_url = (
+      "https://us-central1-autopush-aiplatform.sandbox.googleapis.com"
+  )
+
+  # 1. Create a fresh unique skill first
+  skill_id = f"update_meta_test_skill_{random.randint(10000, 99999)}"
+  with tempfile.TemporaryDirectory() as tmpdir:
+    with open(os.path.join(tmpdir, "SKILL.md"), "w") as f:
+      f.write("# Test Skill\nInitial content.")
+
+    created_skill = client.skills.create(
+        display_name="Original Skill",
+        description="Original Description",
+        config=types.CreateSkillConfig(
+            local_path=tmpdir, skill_id=skill_id, wait_for_completion=True
+        ),
+    )
+
+  # 2. Perform the metadata-only update on the new skill
+  updated_skill = client.skills.update(
+      name=created_skill.name,
+      config=types.UpdateSkillConfig(
+          display_name="My Updated Replay Skill",
+          description="My Updated Replay Skill Description",
+          wait_for_completion=True,
+      ),
+  )
+
+  assert updated_skill.name == created_skill.name
+  assert updated_skill.display_name == "My Updated Replay Skill"
+  assert updated_skill.description == "My Updated Replay Skill Description"
+
+
+def test_update_skill_with_zipped_bytes(client):
+  """Tests the update of a skill with zipped bytes filesystem."""
+  # Target the autopush sandbox endpoint for the Skill Registry API
+  client._api_client._http_options.base_url = (
+      "https://us-central1-autopush-aiplatform.sandbox.googleapis.com"
+  )
+
+  # 1. Create a fresh unique skill first
+  skill_id = f"update_zip_test_skill_{random.randint(10000, 99999)}"
+  with tempfile.TemporaryDirectory() as tmpdir:
+    with open(os.path.join(tmpdir, "SKILL.md"), "w") as f:
+      f.write("# Test Skill\nInitial content.")
+
+    created_skill = client.skills.create(
+        display_name="Original Skill",
+        description="Original Description",
+        config=types.CreateSkillConfig(
+            local_path=tmpdir, skill_id=skill_id, wait_for_completion=True
+        ),
+    )
+
+  # 2. Prepare zipped bytes for update
+  zip_buffer = io.BytesIO()
+  zinfo = zipfile.ZipInfo("SKILL.md", date_time=(1980, 1, 1, 0, 0, 0))
+  with zipfile.ZipFile(zip_buffer, "w") as zip_file:
+    zip_file.writestr(
+        zinfo, "# My Updated Zipped Replay Skill\nThis is updated."
+    )
+  zipped_bytes = zip_buffer.getvalue()
+
+  # 3. Update the skill with new zipped bytes
+  updated_skill = client.skills.update(
+      name=created_skill.name,
+      config=types.UpdateSkillConfig(
+          zipped_filesystem=zipped_bytes, wait_for_completion=True
+      ),
+  )
+
+  assert updated_skill.name == created_skill.name
+  assert (
+      updated_skill.display_name == "Original Skill"
+  )  # Display name remains unchanged