# Generate Agent Card

Generate an A2A agent card JSON by analyzing agent source code in a folder or GitHub URL.

- Repository: https://github.com/agentic-community/mcp-gateway-registry (1032 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card -g -a claude-code -y`
Codex: `npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card -g -a codex -y`
Cursor: `npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card -g -a cursor -y`
Gemini CLI: `npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card -g -a gemini-cli -y`

## Description

Generate an A2A agent card JSON by analyzing agent source code in a folder or GitHub URL. Studies the code to detect agent name, skills, tools, auth, protocol, and generates a spec-compliant agent card.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Generate A2A Agent Card

Generate an A2A (Agent-to-Agent) protocol agent card JSON file by analyzing the source code at `$ARGUMENTS`.

## Steps

### 1. Carefully study the source code

Do NOT just skim the top-level files. Agents can be complex, multi-file projects. You MUST thoroughly explore the entire folder structure before generating the card.

If `$ARGUMENTS` is a local folder path, use Glob to find ALL Python files, YAML/JSON configs, and README files in the folder and its subfolders. Read every relevant file.

If `$ARGUMENTS` is a GitHub URL, use `WebFetch` to read the raw file contents. Follow imports to discover additional files.

**Where to look** (agents are not always a single file):

- **Entrypoints**: `main.py`, `app.py`, `agent_entrypoint.py`, `server.py`, `__main__.py`
- **Tool definitions**: tools may be in separate files like `tools/`, `skills/`, `functions/`, or registered via decorators (`@tool`, `@function_tool`, `@mcp_tool`)
- **Multi-agent setups**: look for orchestrator/supervisor patterns, multiple agent classes, agent registries, sub-agent folders
- **Prompts and system messages**: may be in separate files like `prompts/`, `templates/`, `system_prompt.txt`, or as string constants
- **MCP server connections**: look for MCP client configs, `mcp_servers`, `MCPClient`, tool imports from MCP servers - these are skills the agent can use
- **Config files**: `pyproject.toml`, `requirements.txt`, `.bedrock_agentcore.yaml`, `agent_config.yaml`, `docker-compose.yml`
- **Sub-folders**: check ALL subdirectories for additional agents, tools, or shared utilities

From the code, detect:

The rest: https://github.com/agentic-community/mcp-gateway-registry/blob/HEAD/.claude/skills/generate-agent-card/SKILL.md