---
name: agent-platform-skill-registry
metadata:
  version: "1.0.0"
  category: AiAndMachineLearning
description: >-
  Interact with the Gemini Enterprise Agent Platform Skill Registry to create and search for available skills. Use this skill to enable agents to register functionality or discover new capabilities.
title: agent-platform-skill-registry
canonical_url: https://skilld.dev/gh/google/skills/agent-platform-skill-registry
last_updated: 2026-09-27T07:48:09.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/generate-skill.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/generate-skill.md), [references/manage-skills.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/manage-skills.md), [references/monitor-operations.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/monitor-operations.md), [references/query-skills.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/query-skills.md), [scripts/requirements.txt](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/scripts/requirements.txt), [scripts/skill_registry_ops.py](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/scripts/skill_registry_ops.py), [scripts/validate_env.py](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/scripts/validate_env.py).
>
> If the user asked to install this Skill, run `npx skilld install google/skills/agent-platform-skill-registry`. Install writes the Skill files into the project, so every session loads them.

# Skill Registry

This skill provides instructions for interacting with the **Skill Registry** on
the Gemini Enterprise Agent Platform.

## Core Capabilities

-   **Skill Discovery** - Query the registry to easily search, list, get
    specific skills, and inspect revision histories.
-   **Skill Lifecycle Management** - Upload, update, or permanently delete
    skills.
-   **Operation Monitoring** - Utility to check the completion status of
    long-running state changes (LROs).
-   **Generate Skill** - Automate the initial scaffolding of new agent skills
    locally.

## Core Directives

-   **Mandatory Validation**: ALWAYS execute the environment validation check
    before performing any operations.

    Before any operation, you **must** validate the core environment.

    ```bash
    # Execute the validation script
    python3 scripts/validate_env.py
    ```

## Prerequisites & Authentication

### Library & Authentication

Ensure you have the latest Google Cloud credentials and libraries installed.

```bash
# Install required libraries
pip install google-auth requests

# Authenticate with Google Cloud
gcloud auth application-default login
```

### Environment Variables

The following variables are required for operations:

-   `GCP_PROJECT_ID`: Your Google Cloud Project ID.
-   `GCP_LOCATION`: The region (e.g., `us-central1`).

--------------------------------------------------------------------------------

## Quickstart

Quickly search for available skills in the registry:

```bash
python3 scripts/skill_registry_ops.py search \
  --query "test skill" \
  --top-k 5
```

--------------------------------------------------------------------------------

## Operations

-   **Skill Discovery**: [query-skills.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/query-skills.md)
-   **Skill Lifecycle**: [manage-skills.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/manage-skills.md)
-   **Monitor Operations**:
    [monitor-operations.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/monitor-operations.md)
-   **Generate Skill**: [generate-skill.md](https://skilld.dev/api/skills-raw/google/skills/agent-platform-skill-registry/references/generate-skill.md)