search-benchmark SKILL.md skillA

search-benchmark from agentic-community/mcp-gateway-registry is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add agentic-community/mcp-gateway-registry/search-benchmark@v1.0

Pins v1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
agentic-community/mcp-gateway-registry
Path
.claude/skills/search-benchmark/SKILL.md
Versions recorded
3
Latest version
v1.0, committed Jun 1, 2026
First version recorded
Jun 1, 2026
Size
7,656 bytes
Repository stars
1,034
License
Apache-2.0

Generate a search quality benchmark for the AI Registry. Generates ground truth from the registry's assets, runs 100+ queries against the semantic search API, evaluates results using NDCG@10/MRR/Recall, and produces a markdown report. Use when you want to measure search quality after changes to the scoring algorithm, embedding model, or indexed content.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Search Benchmark Skill

Measure semantic search quality against a deployed AI Registry. Generates a ground truth dataset from the registry's own assets, runs queries against the live API, evaluates results using standard information retrieval metrics (NDCG@10, MRR, Recall@10), and produces a markdown report.

## Prerequisites

1. **Registry URL** - The base URL of the deployed registry (e.g., `https://d2xl2zfuhgc4l0.cloudfront.net`)
2. **JWT Token** - A valid admin token in `.token` file (get from "Get JWT Token" button in registry UI)
3. **Registry must have assets indexed** - At least some servers, agents, or skills registered

The `.token` file supports both raw JWT format and the full JSON response from the registry UI.

## Input

```
/search-benchmark [REGISTRY_URL] [TOKEN_FILE]
```

- **REGISTRY_URL** - Base URL of the registry to benchmark (default: reads from user or uses `http://localhost`)
- **TOKEN_FILE** - Path to the token file (default: `.token`)

## Workflow

### Step 1: Check for Existing Ground Truth

Check if a ground truth dataset already exists:

```bash
ls tests/fixtures/search_dataset/ground_truth.json 2>/dev/null
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add agentic-community/mcp-gateway-registry/search-benchmark@sha256:b8fc3196d7aff1f0

The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hnhnxbnlp2xkdbcc.svg)](https://markdownregistry.com/a/art_hnhnxbnlp2xkdbcc)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, all committed on Jun 1, 2026.

versioncommittedcommitsizeaudit
v1.0 latest2026-06-01 c0c5e3c 7,656 BA view · diff
v1.02026-06-01 061c918 5,519 BA view · diff
v1.02026-06-01 06ae150 5,274 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7656 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

agentic-community/mcp-gateway-registry · 1,034 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hnhnxbnlp2xkdbcc
GET https://markdownregistry.com/api/v1/resolve?ref=agentic-community/mcp-gateway-registry/search-benchmark
GET https://markdownregistry.com/api/v1/blob/b8fc3196d7aff1f0f44418795feec0d8914202d6d207f3cbdb8ea42e30f2a6dc

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from agentic-community/mcp-gateway-registry

agentcore-register SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/agentcore-register/SKILL.md · Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file…
git:20260412.d73bd64 · audit A · 1,034 stars
benchmark-report SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/benchmark-report/SKILL.md · Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON…
v1.0 · audit A · 1,034 stars
create-milestone SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/create-milestone/SKILL.md · Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all…
v2.0 · audit A · 1,034 stars
debug SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/debug/SKILL.md · Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out…
v1.0 · audit A · 1,034 stars
explainer SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/explainer/SKILL.md · Explain a GitHub issue or pull request at 100, 200, and 300 level. Verifies every claim against the code, then writes a…
v1.1 · audit B · 1,034 stars
generate-agent-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-agent-card/SKILL.md · Generate an A2A agent card JSON by analyzing agent source code in a folder or GitHub URL. Studies the code to detect…
git:20260406.3e0708d · audit A · 1,034 stars
generate-server-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-server-card/SKILL.md · Generate an MCP server card JSON (mcp-gateway-registry format) by analyzing server source code in a folder or GitHub…
git:20260406.3e0708d · audit A · 1,034 stars
infra-sync SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/infra-sync/SKILL.md · Keep Terraform and CDK infrastructure in sync. Compares terraform/aws-ecs/ and infra/ to identify discrepancies in ECS…
v1.0 · audit A · 1,034 stars
macos-setup SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/macos-setup/SKILL.md · Complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). Clones the repository, installs all…
v2.0 · audit C · 1,034 stars
new-feature-design SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/new-feature-design/SKILL.md · Design and document new features with GitHub issue, low-level design (LLD), expert review, and testing plan. Creates…
v1.6 · audit C · 1,034 stars
pr-review SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/pr-review/SKILL.md · Review a GitHub pull request using multiple expert personas. Takes a PR URL as input, analyzes the changes, and…
v1.1 · audit C · 1,034 stars
release-notes SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/release-notes/SKILL.md · Create release notes for a new version tag. Gathers all commits, PRs, issues fixed, and breaking changes since a…
v1.0 · audit A · 1,034 stars

Every file in agentic-community/mcp-gateway-registry

Browse by kind, by grade A, or by owner.