> [!WARNING]
>
> **Preview**
>
>
> This product or feature is
>
> subject to the "Pre-GA Offerings Terms" in the General Service Terms section
> of the [Service Specific
> Terms](https://docs.cloud.google.com/terms/service-terms#1).
>
> Pre-GA products and features are available "as is" and might have limited support.
>
> For more information, see the
> [launch stage descriptions](https://cloud.google.com/products/#product-launch-stages).

> [!NOTE]
> **Note:** You can centrally manage and govern standalone skills within [Agent Registry](https://docs.cloud.google.com/agent-registry/overview.md.txt). For details, see [Register skills](https://docs.cloud.google.com/agent-registry/register-skills.md.txt).

Skill Registry serves as a secure, private, and low-latency repository for
managing agent skills. Each skill is a self-contained package, including
structural instructions, executable code, and documentation, designed to extend
an agent's capabilities.

By centralizing these skills, Skill Registry
empowers agents to dynamically discover and load the most relevant capabilities
based on user intent, thereby optimizing performance and ensuring a secure
execution environment.

## Key concepts

Skill Registry introduces two top-level, standard API entities to manage
lifecycle and versioning:

| Concept | Description |
|---|---|
| **Skill** | A mutable top-level entity containing metadata (such as display name, creation and update timestamps, and labels), the default revision, and the skill's content. <br /> For examples of the expected skill structure, see the `SKILL.md` files in the [Google Cloud Skills repository](https://github.com/google/skills/tree/main). |
| **Skill revision** | An immutable snapshot of a specific skill version. It includes a name, a description, and an immutable reference to the parent skill resource. |

## Skill payload validation

To ensure agents can use valid skill content, the system automatically verifies
all skill payloads during creation or updates. These validations are performed
asynchronously.

The asynchronous operation fails with a validation error if the system detects
any of the following:

- The file isn't a proper zip file or is missing key information.
- The zip file is empty.
- The zip file has more than 10,000 items inside.
- The file or folder names in the zip contain `..` or start with `/` or `\\`.
- The zip file contains symbolic links.
- There are duplicate file or folder names in the zip file.
- The total size of all files inside the zip is over 500 MB when unzipped.
- The file is compressed too much, with a compression ratio over 100.
- The folders inside the zip go more than 8 levels deep.
- The zip file does not contain a `SKILL.md` file.
- The `SKILL.md` file has the following issues:
  - The `SKILL.md` file is missing the required YAML front matter or the expected Markdown content.
  - The name field in the YAML front matter is missing, exceeds 64 characters, starts or ends with a hyphen, or contains characters other than lowercase letters, numbers, and hyphens.
  - The description field in the YAML front matter is missing or exceeds 1024 characters.
  - The license field in the YAML front matter exceeds 1024 characters.
  - The instructions in the `SKILL.md` file exceed 500,000 characters.
- The zipped archive is over 10 MB in size.

## Built-in skills

Skill Registry includes a built-in `gcp-skill-registry` skill. This skill
allows agents to interact with Skill Registry to create, search for, and
manage available skills, enabling them to register new functionality or discover
existing capabilities. Google manages the lifecycle, release, and versioning of
this built-in skill, ensuring out-of-the-box functionality.

> [!NOTE]
> **Note:** The system starts the built-in skill ingestion pipeline when you make your first API call to Skill Registry. Because the system provisions this skill during the first call, your first API response doesn't include it; it appears in all subsequent calls.

## What's next

Guide

### [Create and manage skills](https://docs.cloud.google.com/gemini-enterprise-agent-platform/build/skill-registry/create-manage.md.txt)


Learn how to create, update, search, and delete skills in Skill Registry.