Agent Discoverability

Use when publishing or auditing an MCP or agent endpoint so third-party agents can find it, understand its capabilities, and complete its authorized authentication flow.

9 stars 3 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill agent-discoverability
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/agent-discoverability ~/.claude/skills/agent-discoverability

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent Discoverability

Use this Skill when a team owns an Agent/MCP endpoint and wants other agents
and users to find and connect to it. This covers the publish/serve side, not
driving a third party's MCP as a client and not ordinary search-engine SEO.

## Establish ownership and scope

Confirm the exact endpoint, domain, transport, public tools, audience,
authentication model, and operator authorization before changing anything.
Inventory the canonical registry entry, community listings, deployment routes,
well-known documents, DNS zone, certificate owner, and current versions. Never
invent a domain-ownership proof, capability, OAuth URL, DNS record, or token.
Use placeholders in examples and keep real credentials in the authorized
secret store or environment.

## Keep the four discovery surfaces consistent

An agent typically needs four surfaces. They may be delivered incrementally,
but all values must describe the same endpoint:

1. **Registry listing:** canonical name, repository, version, transport, HTTPS
   remote, and capability/manifest URL. Mirror only after the canonical record
   is verified; record each listing's owner and update path.
2. **OAuth discovery:** an unauthenticated protected request returns `401` and
   a `WWW-Authenticate: Bearer` header with a `resource_metadata` URL; the
   protected-resource metadata names the resource and authorization server; the
   authorization-server metadata exposes the actual authorize/token endpoints.
Read the full skill on GitHub

Details

Skill name
agent-discoverability
Path
skills/agent-discoverability/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Agent Discoverability skill do?

Use when publishing or auditing an MCP or agent endpoint so third-party agents can find it, understand its capabilities, and complete its authorized authentication flow.

How do I install the Agent Discoverability skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill agent-discoverability. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Discoverability popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Access Control Security Best Practices

9

sandbaseai/workbuddy-skill

Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.

Security

Accessibility Review

9

sandbaseai/workbuddy-skill

Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.

Frontend & Design

Acquire Codebase Knowledge

9

sandbaseai/workbuddy-skill

Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.

Software Development

Agent Document Design

9

sandbaseai/workbuddy-skill

Use when creating or editing Skills, agent instruction files, or referenced documents so triggers, steps, disclosure, completion criteria, and maintenance remain predictable.

AI, LLMs & Agents

Claude Md Slim

5

adelrioj/claude-skills

Use when CLAUDE.md has grown bloated and is taxing every session's context — the inverse of claude-md-improver. Triages each block into session-invariant rules (stay always-on) vs feature/subsystem detail (page out to docs/ behind a plain-path pointer), moving — never deleting — the detail so nothing is lost and the always-on token bill drops. Triggers on: slim claude.md, minimal claude.md, claude.md is bloated, shrink claude.md, split claude.md, make claude.md minimal, page out claude.md, claude.md too long, reduce project memory, point claude.md to docs, trim claude md.

AI, LLMs & Agents

Agent Evaluation Engineering

9

sandbaseai/workbuddy-skill

Design reproducible evaluations for agent capabilities, trust, safety, trajectories, regressions, latency, and cost.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.