generate-agent-card
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.
npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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
- Steps
- 1. Carefully study the source code
- 2. Generate the agent card JSON
- 3. Populate skills correctly
- 4. Set the endpoint URL
- 5. Detect protocol binding
- 6. Save the output
- 7. Validate the generated JSON
- 8. Report results
- Reference template
python3 -c " import json import sys file_path = '<OUTPUT_FILE_PATH>' Step 1: JSON format check with open(file_path) as f: card = json.load(f) except json.JSONDecodeError as e: Step 2: Required top-level fields errors = []
What does the generate-agent-card skill do?
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.
How do I install it?
Run `npx skills add agentic-community/mcp-gateway-registry --skill generate-agent-card --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From agentic-community/mcp-gateway-registry, a repository with 845 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
