a2aproject / a2aproject/A2A

[Feat]: Rename AgentCard.Skill to AgentCard.Expertise

Open
#1,941 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
Shell
Stars
25.7k
Forks
2.6k
Avg merge
3d 6h
Merged PRs (30d)
16

Description

### Problem:
The term AgentSkills used in the A2A Agent Card is confusing for users.

### Context:
In the wider community, "Agent Skills" usually refers to skill.md files (as seen on [skills.sh](https://www.skills.sh/) and [openagentskill.com](https://www.openagentskill.com/)). However, A2A uses AgentSkills to mean system capabilities.

### Proposed Solution:

Rename the `Skill` parameter to `Expertise` or `Abilities`.

#### Words to Avoid:
* Word `Capabilities ` is already a reserved word for A2A. https://a2a-protocol.org/latest/specification/#443-agentcard
* Word `Function` is a common word is programming languages.
* Word `Skills` is confusing to use here in A2A.

**Benefit:**
This change will fix the current user confusion and make A2A easier to understand alongside other tools.

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.