Off-site verification playground

Companion to feat/orank-offsite-verification. In-repo: skills.sh bi-directional links + server.json version bump. Below: the exact runbook for each login-gated submission.

Verified by this branch's session

Docker image works end-to-end: docker build -t orchestkit-docs-mcp . on merged main, then an MCP initialize + tools/list handshake against docker run -i --rm orchestkit-docs-mcp returned both tools (orchestkit_docs_search, orchestkit_docs_get). This is exactly the check Glama runs.

skills.sh already indexes the repo: www.skills.sh/yonatangross/orchestkit lists the skills (devops-deployment at 700+ installs); npx skills add yonatangross/orchestkit discovers all 111. The orank gap was missing bi-directional verification — this branch adds the links (SAME_AS, homepage, llms.txt).

Runbook 1 — Glama server listing + badge (maintainer login)

  1. Sign in at glama.ai/mcp/servers with GitHub (yonatangross).
  2. Search for yonatangross/orchestkit. If unlisted, submit the repo; if listed, click Claim server.
  3. In the server admin, set the Dockerfile. Either let it use the repo-root Dockerfile (shipped in #2378) or paste its contents — it builds the stdio docs server and passes introspection offline.
  4. Run the checks. Introspection is the bar; the container is verified working (see above).
  5. Copy the badge: https://glama.ai/mcp/servers/yonatangross/orchestkit/badges/score.svg
  6. Resubmit the awesome-mcp-servers entry (old PR #7611 is closed — open a fresh PR) with the badge after the description line: 
    [![yonatangross/orchestkit MCP server](https://glama.ai/mcp/servers/yonatangross/orchestkit/badges/score.svg)](https://glama.ai/mcp/servers/yonatangross/orchestkit)

Runbook 2 — ChatGPT GPT Store (maintainer login)

  1. Go to chatgpt.com/gpts/editor (Plus account required).
  2. Name: OrchestKit Docs · Description: Search and read the OrchestKit documentation — the open-source (MIT) Claude Code plugin with 111 skills, 37 agents, and 210 hooks.
  3. Instructions: "You answer questions about OrchestKit using the attached Actions. Always search first (searchDocs or askQuestion), then fetch pages with batchGetMarkdown for details. Link every answer to its source page on orchestkit.yonyon.ai."
  4. Actions → Import from URL: https://orchestkit.yonyon.ai/api/openapi (no auth).
  5. Privacy policy URL (required for public GPTs): https://orchestkit.yonyon.ai/privacy
  6. Save → Share → GPT Store (Everyone). Category: Programming.

Runbook 3 — MCP registry re-publish (device code, ~2 min)

  1. mcp-publisher login github → authorize the device code at github.com/login/device.
  2. mcp-publisher publish from the repo root (server.json now at the live version).
  3. Verify: curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.yonatangross/orchestkit" shows the new version with isLatest: true.
Consider wiring this into the release flow so the registry entry stops drifting from the released version.

Live re-check

Waiting…