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.
Install
npx skills add sandbaseai/workbuddy-skill --skill agent-discoverabilitygit 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-discoverabilityPersonal 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.
Details
- Skill name
agent-discoverability- Repository
- sandbaseai/workbuddy-skill
- 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
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/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.
Agent Document Design
9sandbaseai/workbuddy-skill
Use when creating or editing Skills, agent instruction files, or referenced documents so triggers, steps, disclosure, completion criteria, and maintenance remain predictable.
Claude Md Slim
5adelrioj/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.
Agent Evaluation Engineering
9sandbaseai/workbuddy-skill
Design reproducible evaluations for agent capabilities, trust, safety, trajectories, regressions, latency, and cost.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.