a2a-tck: Skill for Claude Code

Run TCK Against an SDK Implementation

Follow these steps to help an SDK implementor run the A2A TCK against their SUT.

Step 1: Verify prerequisites

Check that the TCK project is set up:

uv run python --version   # Python 3.11+ required

If dependencies are not installed, run:

uv pip install -e .

Step 2: Confirm the SUT is running and reachable

Ask the user for their SUT URL (e.g., http://localhost:9999).

Verify the SUT is running by fetching its agent card:

curl -s <sut-host>/.well-known/agent-card.json | uv run python -m json.tool

The agent card must be served at {sut-host}/.well-known/agent-card.json per A2A spec Section 8.2.

Agent card requirements

The agent card must include a supportedInterfaces array. Each entry needs:

• protocolBinding — one of "JSONRPC", "GRPC", or "HTTP+JSON"
• url — the endpoint URL for that transport

Example:

{
  "name": "My Agent",
  "supportedInterfaces": [
    { "protocolBinding": "JSONRPC", "url": "http://localhost:9999/jsonrpc" },
    { "protocolBinding": "HTTP+JSON", "url": "http://localhost:9999/a2a" }
  ]
}

If the agent card is missing or malformed, help the user fix it before proceeding.

Step 3: Run the TCK

Important: Always use uv run to invoke the test runner so that the project's virtual environment and dependencies are available. Running ./run_tck.py directly may fail if the system Python lacks pytest or other dependencies.

Reports are always generated in reports/ after every run. Point the user to reports/compatibility.html and reports/tck_report.html after the run completes.

Important: Always run TCK commands from the TCK project root directory (a2a-tck/), not from a subdirectory like sut/a2a-python/.

Start with MUST-level tests to catch blocking issues first:

uv run ./run_tck.py --sut-host <sut-host> --level must -v

Optionally filter by transport (grpc, jsonrpc, http_json):

uv run ./run_tck.py --sut-host <sut-host> --transport jsonrpc --level must -v