benchmark-report
Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON result files and produces a markdown report suitable for docs/benchmarks/.
npx skills add agentic-community/mcp-gateway-registry --skill benchmark-report --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.
# Benchmark Report Skill Generate a markdown benchmark report from stress test result files. The report documents the registry's performance characteristics under load, including registration throughput, API latency, and semantic search concurrency scaling. ## Prerequisites 1. Stress test results must exist in `tests/stress/results/<backend>/size-<N>/` 2. Required files: `registration.json`, `api_perf.json`, `search_concurrency.json` 3. All JSON files should include `registry_info` (deployment configuration snapshot) ## Input ``` /benchmark-report [RESULTS_DIR] [OUTPUT_PATH] ``` - **RESULTS_DIR** - Path to the results directory (default: `tests/stress/results/documentdb/size-100`) - **OUTPUT_PATH** - Where to write the report (default: `docs/benchmarks/benchmark-report.md`) ## Workflow ### Step 1: Run the Report Generator ```bash /usr/bin/python3 .claude/skills/benchmark-report/generate_benchmark_report.py \ --results-dir tests/stress/results/documentdb/size-100 \ --output docs/benchmarks/benchmark-report.md ``` The script reads all three JSON files, extracts the key metrics, and produces a structured markdown report. ### Step 2: Review and Present After generation: 1. Display the
- Prerequisites
- Input
- Workflow
- Step 1: Run the Report Generator
- Step 2: Review and Present
- Report Structure
- Output
What does the benchmark-report skill do?
Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON result files and produces a markdown report suitable for docs/benchmarks/.
How do I install it?
Run `npx skills add agentic-community/mcp-gateway-registry --skill benchmark-report --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.