Agent Platform Skill Registry — Agent Skill by Google

From the author

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.

— the description by Google

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The agent-platform-skill-registry skill provides a comprehensive interface for interacting with the Gemini Enterprise Agent Platform's skill registry. It enables developers and agents to perform lifecycle management tasks such as creating, updating, and deleting skills, as well as searching for existing capabilities. Additionally, it includes utility functions for scaffolding new skills with standardized directory structures and documentation, ensuring consistency across agent development workflows.

What it does

Search, list, and inspect revision histories of available agent skills.
Manage the full lifecycle of skills including uploading, updating, and deletion.
Monitor the status of long-running operations for state changes.
Automate the initial scaffolding of new agent skills with standardized structures.
Validate the local environment to ensure prerequisites are met before operations.
Provide standardized attribution for CLI and API interactions.

When to use it

When you need to discover existing skills to integrate into an agent.
When you are developing a new skill and need to scaffold its structure.
When you need to register or update a skill in the Gemini Enterprise Agent Platform.
When you need to monitor the progress of long-running registry operations.

Advantages

Promotes consistency through standardized directory structures and documentation.
Simplifies the discovery of existing capabilities within the platform.
Provides built-in environment validation to prevent execution errors.
Includes clear guidelines for usage attribution and API interaction.

Usage examples

“Search for skills related to data processing in the registry.”: The agent queries the registry and returns a list of relevant skills matching the 'data processing' query.
“Scaffold a new skill for my agent called 'weather-fetcher'.”: The agent creates the standard directory structure and a draft SKILL.md file for the new skill.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/google/agent-platform-skill-registry/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip agent-platform-skill-registry.zip -d .agents/skills

Documentation by Google

Skill Registry

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

Attribution

MUST READ: Before executing any gcloud, REST API, or MCP command, you MUST read Usage Attribution. For commands executed directly in the terminal (never in generated scripts, Terraform, or user code), prefix gcloud with CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:agent-platform-skill-registry)" and append agent-skills/1.0 (skill:agent-platform-skill-registry) to User-Agent headers.

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.
```
# Execute the validation script
python3 scripts/validate_env.py
```

Prerequisites & Authentication

Library & Authentication

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

# 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:

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

Operations

Skill Discovery: query-skills.md
Skill Lifecycle: manage-skills.md
Monitor Operations: monitor-operations.md
Generate Skill: generate-skill.md

Files

ATTRIBUTION.mdAdded by AutoGineer876 B
LICENSELicence file added by AutoGineer11.1 KiB
SKILL.md2.7 KiB
references/attribution.md1.9 KiB
references/generate-skill.md2.6 KiB
references/manage-skills.md2.4 KiB
references/monitor-operations.md619 B
references/query-skills.md1.5 KiB
scripts/requirements.txt83 B
scripts/skill_registry_ops.pyScript10.8 KiB
scripts/validate_env.pyScript454 B

references/generate-skill.md

Generate Skill

Description

GenerateSkill automates the initial scaffolding of new agent skills by generating standardized documentation (SKILL.md) and directory structures based on user requirements. Note: This tool serves strictly as a starting point. It generates a foundational draft and requires human intervention to refine the logic, review the architecture, and ensure the final skill meets production-level quality standards.

Use when:

Scaffolding a new agent skill from scratch.
Establishing a standardized directory structure for a new tool.
Drafting a properly formatted SKILL.md for a specific use case.

Don't use when:

Executing an existing skill or performing a general query.
Writing general code outside of a skill directory.

Directory Structure

When generating a new skill, the following standardized architecture should be established:

SKILL.md: The core documentation and instruction set for the skill (Required).
references/: Directory for storing heavy external documentation, API specs, or knowledge bases (Optional).
scripts/: Directory for executable scripts, helper functions, or setup files (Optional). Offload complex code snippets, deterministic helper functions, or repetitive setup tasks into this directory to keep SKILL.md lean and focused entirely on high-level instructions and usage patterns.
assets/: Directory for static files, templates, or media used by the skill (Optional).

Execution Workflow

To successfully generate and deliver a new skill draft, follow these sequential steps:

Requirement Gathering: Analyze the user's prompt to understand the purpose, inputs, outputs, and constraints of the desired skill.
Drafting: Generate the SKILL.md content based on the gathered requirements. Ensure the description is concise (under 300 words) and explicitly defines "Use when" and "Don't use when" conditions. Identify and map out necessary optional directories (references/, scripts/, assets/) if applicable, ensuring that any complex or repetitive code logic is offloaded into the scripts/ directory.
Validation: Automatically parse and validate the drafted SKILL.md to ensure strictly valid Markdown formatting (e.g., correct header nesting, closed tags, proper list syntax). Fix any errors before proceeding.
Review Request: Present the generated SKILL.md and directory structure to the user. Explicitly request their review and manual revision, reiterating that human evaluation is required to finalize the draft for production.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs a command-line tool, Needs Python

Security

What our scanner noticed· Low risk

Instructions that use the network
Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Setup Matt Pocock Skills
Matt Pocock· Community
Initializes repository configuration for Matt Pocock's engineering agent skills.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Writing For Agents
Matt Pocock· Community
A framework for writing effective, maintainable documentation and skill definitions for AI agents.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Loop Me
Matt Pocock· Community
A systematic grilling process to define and document recurring workflow specifications.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Writing Skills
Jesse Vincent (obra)· Community
A Test-Driven Development framework for creating, verifying, and maintaining robust agent skills.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository314k
Diagnosing Superpowers
Jesse Vincent (obra)· Community
A systematic workflow for investigating and reporting issues within AI agent sessions.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository314k
Skill Creator
AnthropicOfficial
A comprehensive framework for building, testing, evaluating, and optimizing AI agent skills.
Agent toolingClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskHas scriptsGitHub stars of the source repository188.6k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download agent-platform-skill-registry.zip