ard-connectors/skills/github-copilot/SKILL.md at main · ards-project/ard-connectors · GitHub
Skip to content

Latest commit

 

History

History
97 lines (72 loc) · 3.75 KB

File metadata and controls

97 lines (72 loc) · 3.75 KB
name agentfinder
description Discover installable MCP servers, tools, skills, and agents for a task by searching an ARD Agent Finder. Use whenever the user wants to find or install a tool, MCP server, skill, agent, or integration for something they are trying to do — email, calendars, databases, payments, cloud platforms, CI/CD, messaging, monitoring, file storage, and similar services.
argument-hint <what you want to find>

Find agentic resources (Agent Finder)

Use this skill when the user asks you to find an MCP server, tool, skill, or agent for a task. It searches an ARD Agent Finder (a discovery service) and presents matches for the user to choose from.

Invoke it as /agentfinder <query>, where <query> is the task to find tools for. Also use it whenever the user otherwise asks you to find a tool, MCP server, or integration for a task. Search the registry when the task needs a third-party service (email, calendars, payments, databases, cloud, CI/CD, monitoring, messaging, file storage); skip it for purely local work (writing code, editing files, git, shell, math).

1. Use GitHub's Agent Finder (built in)

This skill already knows where to search — GitHub's Agent Finder:

https://agentfinder.github.com/api/v1/search

Query it directly. Never ask the user for a URL — the endpoint is built in, so /agentfinder <task> works with zero configuration. No authentication is required.

Use a different service only if the user explicitly names one (e.g. Hugging Face Discover, or one from their agent-finders.json). If they give an ARD service base URL (a version root like https://host/api/v1), derive the endpoints from it: append /search to search, /mcp for its MCP endpoint.

2. Query it

Send the user's task as an ARD query object. Use whatever HTTP capability you have (in a terminal, curl):

curl -s https://agentfinder.github.com/api/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"query":{"text":"<the user's task, in plain language>"}}'
  • The body is the ARD spec shape: a query object with a text field. Add an optional query.filter (e.g. {"type":["application/mcp-server+json"]}) to narrow by resource type, and "pageSize": <n> to cap results.

3. Present the results

The response is { "results": [ ... ] }. Each result has displayName, mediaType (the resource type, e.g. application/mcp-server+json), url, identifier, source, and a relevance score. Show a numbered list — for each: displayName, the type, the url, and the score. State that the score is relevance only — not a trust or safety rating.

4. Never auto-install

Do not add, enable, connect, or install any returned resource yourself. Installation is always the user's explicit choice.

5. Install only on request

Once the user picks a result, show them how to add that resource using its url:

  • application/mcp-server+json — add it as an MCP server (a .vscode/mcp.json or claude_desktop_config.json entry, or your client's "add MCP server" flow), pointed at the resource's url.
  • application/ai-skill — install the skill from its url.
  • otherwise — connect to it at its url over its own protocol.

Then stop and let the user act.

Installation

GitHub Copilot — copy this github-copilot/ folder into a directory Copilot scans: ~/.copilot/skills/ (personal) or .github/skills/ (project). Copilot also reads ~/.claude/skills/, so a copy there is picked up too.

cp -r connectors/skills/github-copilot ~/.copilot/skills/

Then invoke /agentfinder <query>.

This skill defaults to GitHub's Agent Finder with no configuration. For a connector that asks which discovery service to use instead, see the generic agentfinder skill.