# Google/Skills Roadmap: Future Development Plans and Architecture Explained

> Explore the google/skills roadmap for future development. Discover plans for expanded cloud coverage, enhanced AI/ML, and a robust plugin ecosystem.

- Repository: [Google/skills](https://github.com/google/skills)
- Tags: architecture
- Published: 2026-08-14

---

**The google/skills repository roadmap focuses on expanding cloud service coverage, deepening AI/ML capabilities, and improving the plugin ecosystem while maintaining its core architecture of Markdown-based skill definitions and CLI-driven installation.**

The google/skills repository powers Google's open-source **Agent Skills** collection—modular, documentation-driven tutorials that enable AI agents to interact with Google Cloud services. As an actively developed project, its future direction is shaped by the current structure in [`README.md`](https://github.com/google/skills/blob/main/README.md), the skill template pattern in [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) files, and the plugin architecture defined throughout the codebase.

## Core Architecture Driving Future Development

The repository's design philosophy centers on three components that will guide all roadmap decisions:

- **Skill definitions** — Each skill resides in its own directory (e.g., `skills/cloud/gke-upgrades/`) containing a [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) file that defines workflows, prerequisites, and execution steps.
- **Installation CLI** — Users install skills via `npx skills add google/skills`, which parses the repository's catalog.
- **Plugin ecosystem** — Plugins for Claude, Codex, and Antigravity expose skills as executable modules across AI platforms.

This architecture ensures that roadmap expansions remain consistent and discoverable.

## Planned Development Milestones

Based on the repository's current structure and explicit "under active development" status, the roadmap includes seven key initiatives:

### 1. Expanded Cloud Service Coverage

New skills will target emerging Google Cloud services including **Vertex AI**, **BigLake**, **Data Fusion**, and **Google Secure Source Manager**. Each follows the established [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) format.

### 2. Advanced AI/ML Capabilities

The Agent Platform suite will grow with skills for **Model Garden Deploy**, **Prompt Management**, multi-modal prompting, and fine-tuning pipelines.

### 3. Infrastructure-as-Code Integration

Reusable **Terraform modules** and step-by-step guides will enable autonomous resource provisioning—for example, **GKE AI/ML Inference** and **Workload Scaling**.

### 4. CLI and Plugin Refinements

The `skills` CLI will gain version checking and improved error handling, allowing agents to recover from transient failures.

### 5. Automated Skill Validation

Markdown linting and unit tests via a `skill-test` harness will ensure skills remain functional as Google APIs evolve.

### 6. Community Contribution Improvements

Enhanced [`CONTRIBUTING.md`](https://github.com/google/skills/blob/main/CONTRIBUTING.md) guidelines and issue templates will support new languages (Python, Go, Java) and external contributors.

### 7. Observability Expansion

Extended **Cloud Monitoring** and **Logging** skills will cover SLO alerts and cross-project log aggregation.

## Key Files Supporting the Roadmap

| File | Purpose | Source Link |
|------|---------|-------------|
| [`README.md`](https://github.com/google/skills/blob/main/README.md) | Installation guide and skill catalog | [`google/skills/blob/main/README.md`](https://github.com/google/skills/blob/main/google/skills/blob/main/README.md) |
| [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) | Skill workflow template | [`google/skills/blob/main/skills/cloud/gke-upgrades/SKILL.md`](https://github.com/google/skills/blob/main/google/skills/blob/main/skills/cloud/gke-upgrades/SKILL.md) |
| [`CONTRIBUTING.md`](https://github.com/google/skills/blob/main/CONTRIBUTING.md) | Contribution guidelines | [`google/skills/blob/main/CONTRIBUTING.md`](https://github.com/google/skills/blob/main/google/skills/blob/main/CONTRIBUTING.md) |
| `.gitmodules` | Sub-repository tracking | `google/skills/blob/main/.gitmodules` |

## Practical Examples

Install a skill using the CLI:

```bash
npx skills add google/skills

```

Add the Claude plugin:

```bash
claude plugin marketplace add google/skills
claude plugin install <plugin>@google-plugins

```

Create a new skill following the template:

```bash
mkdir -p skills/cloud/new-service

cat > skills/cloud/new-service/SKILL.md <<'EOF'

# New Service Skill

## Description

Explain the service and agent use case.

## Prerequisites

- gcloud SDK installed
- Service API enabled

## Steps

1. Authenticate
2. Call API
3. Process response
EOF

```

## Summary

- The google/skills roadmap prioritizes **modular expansion** through the existing [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) pattern
- Seven milestone areas cover cloud services, AI/ML, IaC, CLI improvements, testing, community, and observability
- All developments maintain compatibility with the `npx skills` CLI and plugin architecture
- Contributors can extend the repository using standard Git workflows and the documented template

## Frequently Asked Questions

### How can I contribute a new skill to google/skills?

Fork the repository, create a skill directory with a [`SKILL.md`](https://github.com/google/skills/blob/main/SKILL.md) file following the template in [`skills/cloud/gke-upgrades/SKILL.md`](https://github.com/google/skills/blob/main/skills/cloud/gke-upgrades/SKILL.md), and submit a pull request. The [`CONTRIBUTING.md`](https://github.com/google/skills/blob/main/CONTRIBUTING.md) file provides detailed guidelines for structure and review requirements.

### What AI platforms are supported by google/skills plugins?

According to the [`README.md`](https://github.com/google/skills/blob/main/README.md) plugins section, the repository currently supports **Claude**, **Codex**, and **Antigravity** through dedicated plugin integrations that expose skills as executable modules.

### Is there a testing framework for validating skills?

While not yet fully implemented, the roadmap includes a `skill-test` harness for automated Markdown linting and unit testing. Skills currently rely on manual validation against live Google Cloud APIs.

### How do I install a specific skill rather than the entire repository?

Use the `npx skills add google/skills` command, which presents a selectable list of available skills parsed from the repository's catalog in [`README.md`](https://github.com/google/skills/blob/main/README.md).