# Agent Platform API . projects . locations . skills . revisions

## Instance Methods

Close httplib2 connections.

Get a Skill Revision.

List Skill Revisions for a Skill.

Retrieves the next page of results.

### Method Details

`close()`

    Close httplib2 connections.

`get(name, x__xgafv=None)`

    Get a Skill Revision.

    Args:
      name: string, Required. The resource name of the Skill Revision to retrieve. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A revision of a Skill.
      "createTime": "A String", # Output only. Timestamp when this Skill Revision was created.
      "name": "A String", # Identifier. The resource name of the Skill Revision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
      "skill": { # A skill. # Output only. The state of the Skill at this revision.
        "compatibility": "A String", # Optional. Specifies the compatibility of the Skill. Indicates environment requirements (intended product, system packages, network access, etc.). This should align with `compatibility` in the `SKILL.md` file.
        "createTime": "A String", # Output only. Timestamp when this Skill was created.
        "description": "A String", # Required. Describes the Skill. Should describe both what the skill does and when to use it. Should include specific keywords that help agents identify relevant tasks. This should align with `description` in the `SKILL.md` file.
        "displayName": "A String", # Required. Provides the display name of the Skill. This should align with `name` in the `SKILL.md` file.
        "labels": { # The labels with user-defined metadata to organize Skills.
          "a_key": "A String",
        },
        "license": "A String", # Optional. Specifies the license of the Skill. This should be an SPDX license identifier (e.g., "MIT", "Apache-2.0"). See https://spdx.org/licenses/. This should align with `license` in the `SKILL.md` file.
        "name": "A String", # Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`
        "sha256": "A String", # Output only. The SHA256 checksum of the zipped filesystem.
        "skillSource": "A String", # Output only. The source of the Skill.
        "state": "A String", # Output only. The state of the Skill.
        "updateTime": "A String", # Output only. Timestamp when this Skill was most recently updated.
        "zippedFilesystem": "A String", # Required. Provides the zipped filesystem of the Skill. This should contain the `SKILL.md` file at the root of the zip and optional directories for scripts, references, and assets. Directory should align with the directory structure specified at https://agentskills.io/specification#directory-structure.
      },
      "state": "A String", # Output only. The state of the Skill Revision.
    }

`list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)`

    List Skill Revisions for a Skill.

    Args:
      parent: string, Required. The resource name of the Skill to list revisions for. Format: `projects/{project}/locations/{location}/skills/{skill}` (required)
      filter: string, Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields (equality match only): * `labels`
      pageSize: integer, Optional. The standard list page size.
      pageToken: string, Optional. The standard list page token.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for SkillRegistryService.ListSkillRevisions.
      "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
      "skillRevisions": [ # The list of Skill Revisions in the request page.
        { # A revision of a Skill.
          "createTime": "A String", # Output only. Timestamp when this Skill Revision was created.
          "name": "A String", # Identifier. The resource name of the Skill Revision. Format: `projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}`
          "skill": { # A skill. # Output only. The state of the Skill at this revision.
            "compatibility": "A String", # Optional. Specifies the compatibility of the Skill. Indicates environment requirements (intended product, system packages, network access, etc.). This should align with `compatibility` in the `SKILL.md` file.
            "createTime": "A String", # Output only. Timestamp when this Skill was created.
            "description": "A String", # Required. Describes the Skill. Should describe both what the skill does and when to use it. Should include specific keywords that help agents identify relevant tasks. This should align with `description` in the `SKILL.md` file.
            "displayName": "A String", # Required. Provides the display name of the Skill. This should align with `name` in the `SKILL.md` file.
            "labels": { # The labels with user-defined metadata to organize Skills.
              "a_key": "A String",
            },
            "license": "A String", # Optional. Specifies the license of the Skill. This should be an SPDX license identifier (e.g., "MIT", "Apache-2.0"). See https://spdx.org/licenses/. This should align with `license` in the `SKILL.md` file.
            "name": "A String", # Identifier. The resource name of the Skill. Format: `projects/{project}/locations/{location}/skills/{skill}`
            "sha256": "A String", # Output only. The SHA256 checksum of the zipped filesystem.
            "skillSource": "A String", # Output only. The source of the Skill.
            "state": "A String", # Output only. The state of the Skill.
            "updateTime": "A String", # Output only. Timestamp when this Skill was most recently updated.
            "zippedFilesystem": "A String", # Required. Provides the zipped filesystem of the Skill. This should contain the `SKILL.md` file at the root of the zip and optional directories for scripts, references, and assets. Directory should align with the directory structure specified at https://agentskills.io/specification#directory-structure.
          },
          "state": "A String", # Output only. The state of the Skill Revision.
        },
      ],
    }

`list_next()`

    Retrieves the next page of results.

            Args:
              previous_request: The request for the previous page. (required)
              previous_response: The response from the request for the previous page. (required)

            Returns:
              A request object that you can call 'execute()' on to request the next
              page. Returns None if there are no more items in the collection.