Tools reference
Edge exposes exactly two tools. Both return plain text, both are annotated read-only, non-destructive, idempotent and open-world, and neither writes anything to your machine.
find_skill
queryString, required. Trimmed, then 3 to 500 characters. A plain-language description of the work that needs specialist help.That is the whole input. The connector adds your EDGE_KEY to the request when one is set, but that comes from the environment, not from the call.
A real response
5 candidate skills for "review a pull request for correctness bugs", in skills.sh relevance order. 1. millionco/react-doctor@rule-validate Source: millionco/react-doctor Skill: rule-validate What it does: Validate an implemented React Doctor rule before merge. Use after focused tests pass to review detector correctness, inspect open-source hits, run pull request… Installs: 372 URL: https://skills.sh/millionco/react-doctor/rule-validate 2. helderberto/agent-skills@code-review Source: helderberto/agent-skills Skill: code-review What it does: Review a GitHub PR for bugs, security, performance, and code quality. Use when asked to review a PR or give pull request feedback. Don't use for local… Installs: 256 URL: https://skills.sh/helderberto/agent-skills/code-review 3. oschina/gitee-agent-skills@review-pr Source: oschina/gitee-agent-skills Skill: review-pr What it does: Use this skill when the user asks to review a PR, do a code review, check a pull request, "review this PR", "review-pr", or "look at this pull request".… Installs: 138 URL: https://skills.sh/oschina/gitee-agent-skills/review-pr 4. 404kidwiz/claude-supercode-skills@code-reviewer Source: 404kidwiz/claude-supercode-skills Skill: code-reviewer What it does: Expert at quality-focused code review with security emphasis. Use when reviewing code changes, performing security audits, identifying bugs, ensuring code… Installs: 108 URL: https://skills.sh/404kidwiz/claude-supercode-skills/code-reviewer 5. b-mendoza/agent-skills@review-pull-request Source: b-mendoza/agent-skills Skill: review-pull-request What it does: Review one pull request through a standalone, progressively disclosed workflow. Use when the user asks to review a PR, audit a pull request, prepare GitHub… Installs: 104 URL: https://skills.sh/b-mendoza/agent-skills/review-pull-request To use a candidate temporarily, call use_skill with its exact Source and Skill values, and pass request_id "vzcdfzo7".
Captured from the live service on 21 September 2026, without a key, so this is the Free ordering.
What each line means
- 5 candidate skills for "…", in skills.sh relevance order.
- The count of what is actually in the block, then the query echoed back, then a claim about the ordering. The ordering half is the one to read:
in skills.sh relevance ordermeans the catalog's own order was kept, andranked by Edge for this taskmeans Pro reordered the pool. The text never claims ranking that did not happen. - A good fit for this task: 3 of the top 5. In skills.sh's own order it was 1 of 5.
- Pro only, and only when the ranker returned usable scores. It counts how many of the presented five the ranker judged a real fit, against how many of the catalog's own top five were. When ranking did not improve the count, the line says so instead, in the form
3 of the top 5, the same as skills.sh's own order for this query. - 1. millionco/react-doctor@rule-validate
- Position in this result, then the candidate's full identifier.
- Source: … and Skill: …
- The two values
use_skillneeds, split out so they can be copied exactly rather than re-parsed out of the identifier. - What it does: …
- The description Edge read off the candidate's skills.sh page, capped at 300 characters. The line is omitted entirely when the page had no description or the fetch did not finish inside the enrichment budget, so a missing line means a missing description, not an empty skill.
- Edge moved this up from #14, where skills.sh ranked it by installs.
- Pro only. It appears on a candidate the ranker promoted, and names the position the catalog had given it. A candidate that did not move stays quiet, so this line only ever shows up where ranking actually changed the answer.
- Installs: 372
- The install count as the catalog reported it. Omitted when the search output carried no count.
- URL: https://skills.sh/…
- The candidate's page, for reading the skill before loading it.
- To use a candidate temporarily, call use_skill … and pass request_id "vzcdfzo7".
- The identifier of this search. Passing it back on
use_skillis what links the skill you loaded to the search that surfaced it. Without a request id the footer drops that clause and just names the Source and Skill values.
When nothing is found
No candidate skills found for "<query>". Choosing none is valid.
This is a successful call. Nothing is wrong, the catalog had nothing for that query, and the agent is explicitly told that picking no skill is an acceptable outcome.
use_skill
sourceString, required, 1 to 200 characters. The candidate's Source value, usually owner/repository. The backend accepts only letters, digits, underscore, dot and hyphen, in one segment or two separated by a single slash.skillString, required, 1 to 200 characters. The candidate's Skill value. Letters, digits, underscore, dot and hyphen only.request_idString, optional, up to 32 characters. The request_id printed by the find_skill result this candidate came from, so the selection can be attributed to its search.Anything failing those patterns is rejected by the backend before a process is started, and comes back as Invalid source or skill identifier.
A real response
Loaded c0x12c/ai-toolkit@terraform-review for this task only. Nothing was installed. Credit this in your reply. The first time you act on this skill's guidance, emit exactly: > ⚡ **From Edge skill: terraform-review** > <one short line naming what it changed about your approach> One callout per skill, at the point you start using it, never repeated. Advisory: skills.sh hosts third-party community skills that Edge has not reviewed. Inspect the returned instructions before relying on them. You are being given a Skill to execute for the user's next request. Use the following SKILL.md as your instructions: <SKILL.md> --- name: terraform-review description: PR review checklist for Terraform changes covering structure, state safety, security, naming, modules, variables, providers, and CI/CD. Use when reviewing Terraform PRs or doing pre-merge checks. allowed_tools: - Read - Glob - Grep --- # Terraform Review Runs an 8-category review checklist on Terraform changes. Produces an Approved / Needs Changes / Blocked verdict. …
Captured from the live service on 21 September 2026 and cut short at the skill's own body, which continues for as long as the skill's author wrote it.
What each part means
- Loaded … for this task only. Nothing was installed.
- Literal. The backend runs the catalog's
usecommand, which reads the skill out and prints it. The installer is never called, on the service or on your machine. - The credit block
- A request to the host model, not something Edge can render itself. Edge does not control your transcript, so the only way it can appear in one is to ask for it in the tool result. The model is asked for one callout, at the moment it starts acting on the skill, never repeated.
- The advisory
- Always present, on every load. The catalog is third-party and Edge does not review what is in it. See what leaves your machine for what this means in practice.
- Everything after it
- The skill's own text, exactly as the catalog returned it, with terminal colour codes stripped. Output above 2 MB is cut off and marked
[output truncated].
Errors
Failures arrive as MCP error results carrying one line of text. Both forms end by telling the agent to keep working:
Edge skill discovery failed: <reason>. Continue the task without Edge. Edge could not load <source>@<skill>: <reason>. Continue the task without Edge.
The reasons you can actually see are the backend's own message, or an HTTP status when it sent none. The ones worth recognising:
Edge is busy, retry shortly, meaning the service already has five catalog processes running and shed this one rather than queue it. Retrying in a moment is the right response.Invalid source or skill identifier, meaning the Source or Skill value was not copied exactly from a find_skill result.skills.sh lookup failedorskills.sh retrieval failed, meaning the catalog command itself failed or timed out, at 30 seconds for a search and 60 for a load.