From 82586ee9ff8ac095c81bf4db25c2bb3952054ef0 Mon Sep 17 00:00:00 2001
From: Mathieu Colla <55652304+Math1987@users.noreply.github.com>
Date: Mon, 7 Sep 2026 16:28:45 +0200
Subject: [PATCH] docs: fix a2a skill setup and binary naming

---
 skills/a2a-cli/README.md | 12 ++++++++++--
 skills/a2a-cli/SKILL.md  | 10 +++++++---
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/skills/a2a-cli/README.md b/skills/a2a-cli/README.md
index 047534b..d504809 100644
--- a/skills/a2a-cli/README.md
+++ b/skills/a2a-cli/README.md
@@ -13,12 +13,20 @@ It is one file, `SKILL.md`. Once it is installed, your agent can:
 
 ## Prerequisite
 
-The skill drives the `a2a` binary; it does not install it. Install `a2a` first:
+The skill drives the `a2a` binary; it does not install it. With a Go toolchain
+matching the repository's `go.mod`, build it from source with the expected name:
 
 ```bash
-go install github.com/a2aproject/a2a-cli@latest
+git clone https://github.com/a2aproject/a2a-cli.git
+cd a2a-cli
+go build -o a2a .
+export PATH="$PWD:$PATH"
 ```
 
+The PATH change applies to this shell. For future sessions, place the binary in
+a directory on your PATH. A plain `go install` names the executable `a2a-cli`,
+whereas this skill invokes `a2a`.
+
 Confirm it is on your `PATH`:
 
 ```bash
diff --git a/skills/a2a-cli/SKILL.md b/skills/a2a-cli/SKILL.md
index 431a41a..1fec6be 100644
--- a/skills/a2a-cli/SKILL.md
+++ b/skills/a2a-cli/SKILL.md
@@ -41,13 +41,17 @@ returned.
 
 ## Setup
 
-Check for the binary; install from source if missing (needs a Go toolchain from
-https://go.dev/doc/install); re-run to update:
+Check that the binary is available:
 
 ```bash
-go install github.com/a2aproject/a2a-cli@latest
+a2a version
 ```
 
+If it is missing, ask the user to install it using the
+[setup instructions](https://github.com/a2aproject/a2a-cli/blob/main/skills/a2a-cli/README.md#prerequisite),
+then retry the check. The binary must be available as `a2a` on PATH; the skill
+does not install or update it.
+
 The tool is under active development. Treat `a2a help` and `a2a <command>
 --help` as the source of truth for the current commands and flags.