Agent skill

Update A2a Proto

Update the A2A Protobuf file (a2a.proto) when the A2A protocol specification changes.

Apache-2.0Auto-check passedBackend & APIs

Install Update A2a Proto

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-a2a-proto .claude/skills/update-a2a-proto && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .claude/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/update-a2a-proto .agents/skills/update-a2a-proto && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .agents/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/update-a2a-proto .cursor/skills/update-a2a-proto && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .cursor/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/a2aproject/a2a-java.git --path .agents/skills/update-a2a-proto

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/update-a2a-proto .gemini/skills/update-a2a-proto && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .gemini/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/update-a2a-proto .github/skills/update-a2a-proto && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .github/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add a2aproject/a2a-java --skill update-a2a-proto -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install a2aproject/a2a-java update-a2a-proto --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/a2aproject/a2a-java.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/update-a2a-proto .opencode/skills/update-a2a-proto && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "update-a2a-proto" agent skill from https://github.com/a2aproject/a2a-java/tree/main/.agents/skills/update-a2a-proto into .opencode/skills/update-a2a-proto/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-a2a-proto", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: update-a2a-proto
GitHub stars: 504
Token cost: ~738 tokens
SKILL.md length: 346 words
Files: 1
Skills in repo: 3
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Update the A2A Protobuf file (a2a.proto) when the A2A protocol specification changes.

Works in 8 steps: Capture the current state → Download the updated specification → Analyze specification changes → …
The user mentions updating the spec
SKILL.md covers Step 1: Capture the current…, Step 2: Download the updated…, Step 3: Analyze specification… and Step 4: Regenerate gRPC classes, plus 4 more sections
Calls mvn

What it does

Update A2a Proto is an agent skill from a2aproject/a2a-java. Update the A2A Protobuf file (a2a.proto) when the A2A protocol specification changes. Use when the user mentions updating the spec, syncing with upstream A2A, or when a new version of the A2A protocol is released.

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires curl

It sits in Backend & APIs, covering gRPC and Protobuf. It works with Agent2Agent Protocol, gRPC and Java. The repository describes itself as: Official Java SDK for the Agent2Agent (A2A) Protocol. The licence is Apache-2.0.

When your agent uses it

The user mentions updating the spec
Syncing with upstream A2A
A new version of the A2A protocol is released

Example prompts

“/update-a2a-proto”

Requirements

Compatibility (from SKILL.md): Requires curl
Pre-approved tools (allowed-tools): Bash(mvn:*), Bash(curl:*), Read, Edit, Write, Glob, Grep

Workflow steps

8 steps, taken from the step headings in SKILL.md.

Capture the current state
Download the updated specification
Analyze specification changes
Regenerate gRPC classes
Update the code
Validate
Audit changes
Summarize

What it can do on your machine

Read from SKILL.md and the folder at commit fc2e96e. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(mvn:*)
- Bash(curl:*)
- Read
- Edit
- Write
- Glob
- Grep
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- mvn
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires curl
From compatibility in the SKILL.md frontmatter.

Context cost

Update A2a Proto loads about 738 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 346 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~58
When it runs · the whole SKILL.md, loaded when a task matches: ~738

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from a2aproject/a2a-java at commit fc2e96e, republished under its Apache-2.0 licence (© a2aproject). 346 words, ~738 tokens.

Download SKILL.mdSave it as .claude/skills/update-a2a-proto/SKILL.md (or your agent's skills folder).

name: update-a2a-proto
description: Update the A2A Protobuf file (a2a.proto) when the A2A protocol specification changes. Use when the user mentions updating the spec, syncing with upstream A2A, or when a new version of the A2A protocol is released.
allowed-tools: Bash(mvn:*), Bash(curl:*), Read, Edit, Write, Glob, Grep
compatibility: Requires curl

Update a2a.proto

Update the A2A gRPC proto file from the upstream specification repository and regenerate Java sources.

Step 1: Capture the current state

Before updating, record what we have now so we can diff later.

Read spec-grpc/src/main/proto/a2a.proto to note the current commit hash (located at the top of the file in a comment)
Save a copy of the file for diffing:

Step 2: Download the updated specification

Ask the user if they want to update from the main branch or pass a tag or a commit cheksum
Download the latest a2a.proto from the upstream A2A repository at https://github.com/a2aproject/A2A/blob/main/specification/a2a.proto and save it to spec-grpc/src/main/proto/a2a.proto.
Update the java_package option in the downloaded proto file to:
```
option java_package = "org.a2aproject.sdk.grpc";
```
Update the comment tracking the upstream commit hash (line starting with // From commit) to the commit hash / tag of the downloaded proto file.

Step 3: Analyze specification changes

Compare the old and new versions of the specification to identify changes:

Diff specification/a2a.proto with the backup to find:
- New or changed message types
- New or changed RPC methods
- New or changed fields

Step 4: Regenerate gRPC classes

Delete all the generated gRPC Java classes (in case of resources removed from the Protobuf definitions):
bash
```
find spec-grpc/src/main/java/org/a2aproject/sdk/grpc -maxdepth 1 -name "*.java" -delete```
```

Regenerate gRPC Java classes by running:

bash

mvn generate-sources -pl spec-grpc -Dskip.protobuf.generate=false

Show full SKILL.md (136 more words)Show less

Step 5: Update the code

Based on the spec diff, update the relevant files

Summarize the changes for the user before proceeding.

Step 6: Validate

Run the tests on all modules to verify the update

bash

mvn clean install

Fix any issues before proceeding.

Step 7: Audit changes

Before committing, audit all code changes.

Highlight any new, modified, or removed changes in the API in the client, common, server-common, and spec modules

Verify the build succeeds for the full project:

bash

mvn clean install

Step 8: Summarize

Present the user with a summary of:

The old and new spec commit hashes
What changed in the specification
What was updated in the code
Any areas that need manual review or additional test coverage
Impact on user API (from the client, common, server-common, and spec modules)
- Write a "migration summary" for breaking changes in the API

Files

Just SKILL.md in .agents/skills/update-a2a-proto of a2aproject/a2a-java.

Open the folder on GitHubat commit fc2e96e

Compare with similar skills

Update A2a Proto next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Update A2a Proto compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Update A2a Proto this skilla2aproject/a2a-java	504	—	~738	Automated safety check: Pass	Apache-2.0	2 days ago
Using Dotnetnovotnyllc/dotnet-artisan	233	—	~2.3k	Automated safety check: Warn	MIT	today
Databricks Zerobus Ingestdatabricks/databricks-agent-skills	345	—	~3.1k	Automated safety check: Pass	Custom licence	today
Doca Flow Grpc ServerNVIDIA/skills	3.5k	—	~4.2k	Automated safety check: Pass	Apache-2.0	yesterday
Use Yaakmountain-loop/yaak	19k	—	~1.9k	Automated safety check: Pass	MIT	yesterday
Golang Proantoniopaya22/go-rest-template	172	3 repos	~1.2k	Automated safety check: Pass	MIT	6 mo ago

Similar skills

Using Dotnet
novotnyllc/dotnet-artisan
Detects .NET intent for any C, ASP.NET Core, EF Core, Blazor, MAUI, Uno Platform, WPF, WinUI, SignalR, gRPC, xUnit, NuGet, or MSBuild request from prompt keywords and repository signals (.sln…
233 GitHub stars~2.3k tokensUpdated today
Backend & APIsAuto-check: warnings
Databricks Zerobus Ingest
databricks/databricks-agent-skills
Official
Build Zerobus Ingest clients for near real-time data ingestion into Databricks Delta tables via gRPC.
345 GitHub stars~3.1k tokensUpdated today
Backend & APIsAuto-check passed
Doca Flow Grpc Server
NVIDIA/skills
Official
PLAINTEXT-ONLY: the shipped docaflowgrpc server uses grpc::InsecureServerCredentials() with NO TLS / mTLS / token-auth knob on the binary — transport security must come from external infrastructure…
3.5k GitHub stars~4.2k tokensUpdated yesterday
Backend & APIsAuto-check passed
Use Yaak
mountain-loop/yaak
A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…
19k GitHub stars~1.9k tokensUpdated yesterday
Backend & APIsAuto-check passed
Golang Pro
antoniopaya22/go-rest-template
Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with…
172 GitHub starsUsed in 3 repos~1.2k tokens
Backend & APIsAuto-check passed
Debug Grpc Connection
GetBindu/Bindu
Diagnose gRPC connection issues between the Bindu core and a language SDK.
10k GitHub stars~1.2k tokensUpdated 1 mo ago
Backend & APIsAuto-check passed

Questions about Update A2a Proto

What does Update A2a Proto do?

Update the A2A Protobuf file (a2a.proto) when the A2A protocol specification changes. Update A2a Proto is an agent skill from a2aproject/a2a-java.proto) when the A2A protocol specification changes.

When should I use Update A2a Proto?

Update A2a Proto fits situations like: the user mentions updating the spec; syncing with upstream A2A; A new version of the A2A protocol is released.

How do I install Update A2a Proto in Claude Code?

Run `npx skills add a2aproject/a2a-java --skill update-a2a-proto -a claude-code`. Or copy the skill folder (.agents/skills/update-a2a-proto in a2aproject/a2a-java) into .claude/skills/update-a2a-proto in your project. Claude Code loads it when a task matches its description.

How do I install Update A2a Proto in Codex?

Run `npx skills add a2aproject/a2a-java --skill update-a2a-proto -a codex`. Or copy the skill folder (.agents/skills/update-a2a-proto in a2aproject/a2a-java) into .agents/skills/update-a2a-proto in your project. Codex loads it when a task matches its description.

Can I use Update A2a Proto in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add a2aproject/a2a-java --skill update-a2a-proto -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-a2a-proto, .gemini/skills/update-a2a-proto, .github/skills/update-a2a-proto and .opencode/skills/update-a2a-proto in your project.

What does Update A2a Proto need to run?

Going by SKILL.md and its folder, Update A2a Proto needs the command-line tools its instructions call (mvn). Its frontmatter pre-approves these tools: Bash(mvn:*), Bash(curl:*), Read, Edit, Write, Glob, Grep. Compatibility (from SKILL.md): Requires curl.

Does Update A2a Proto access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Update A2a Proto safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Update A2a Proto use?

Update A2a Proto is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update A2a Proto use?

About 738 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Update A2a Proto?

Skills that share tags, products or a category with Update A2a Proto: Using Dotnet (novotnyllc/dotnet-artisan, 233 stars), Databricks Zerobus Ingest (databricks/databricks-agent-skills, 345 stars), Doca Flow Grpc Server (NVIDIA/skills, 3.5k stars) and Use Yaak (mountain-loop/yaak, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update A2a Proto?

a2aproject (a GitHub organization) maintains it in a2aproject/a2a-java, which has 504 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 6, 2026.

Source: a2aproject/a2a-java on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Update A2a Proto

Install Update A2a Proto

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Update a2a.proto

Step 1: Capture the current state

Step 2: Download the updated specification

Step 3: Analyze specification changes

Step 4: Regenerate gRPC classes

Step 5: Update the code

Step 6: Validate

Step 7: Audit changes

Step 8: Summarize

Files

Compare with similar skills

Similar skills

Using Dotnet

Databricks Zerobus Ingest

Doca Flow Grpc Server

Use Yaak

Golang Pro

Debug Grpc Connection

More from a2aproject/a2a-java

Fix Tck Issue

Release A2a

Questions about Update A2a Proto

Install Update A2a Proto

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Update a2a.proto

Step 1: Capture the current state

Step 2: Download the updated specification

Step 3: Analyze specification changes

Step 4: Regenerate gRPC classes

Step 5: Update the code

Step 6: Validate

Step 7: Audit changes

Step 8: Summarize

Files

Compare with similar skills

Similar skills

More from a2aproject/a2a-java

Related

Questions about Update A2a Proto