Skip to main content
GET
Find a skill for a task
Put the task in q, in plain words, for example find LinkedIn jobs in Toronto. Matching reads the meaning of q, not only its words. A query that names a site, such as linkedin, lifts that site’s skills; a skill on another site is then only a near match. Narrow the search with site (only skills for this website, for example linkedin.com) and category. limit is 1–50, default 10. kind picks what to search: skill (the default) or workflow. See Workflows. Results are ranked by how well they match, weighed by health (success rate over the last 20 runs, and a recent success) and a little by use. When no skill does the task, up to 3 of the closest come back with match: "near", and hint says so. You can then record exactly this task with Create a skill. Otherwise hint is null. Searching the public marketplace needs no key. With a key or session that holds skills:read, your own skills and your workspaces’ are searched too. A key without skills:read searches the marketplace only. A bad key is still a 401. A skill that is not yours runs only after you clone it. Running it directly returns 403 clone_required. See Errors. MCP tool: search_skills.

Workflows

With kind=workflow, the results are workflows, in the same shape:
  • inputs, price, sample_rows, match, and score work as for skills. price is the typical cost of its last 20 completed runs, or its base fee before any. Sample rows hold no secret fields, and long values are cut short.
  • health has total_runs only.
  • site and official are not used. The site filter does not apply.
  • run_url is Run a workflow and wait, info_url is Get a workflow, and clone_url is Clone a workflow. clone_url is null when yours is true. A workflow that is not yours answers 404 to a run until you clone it.
With a key or session that holds workflows:read, your own workflows and your workspaces’ are searched too. When no workflow does the task, the closest come back with match: "near", and hint points to Create a workflow. MCP tool: search_workflows.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Query Parameters

q
string
required

The task, in your words: 'find LinkedIn jobs in Toronto'

Required string length: 2 - 300
site
string | null

Only skills for this website, e.g. linkedin.com

Maximum string length: 200
category
string | null
Maximum string length: 100
limit
integer
default:10

Most results to return, 1–50.

Required range: 1 <= x <= 50
kind
enum<string>
default:skill

Search skills or workflows

Available options:
skill,
workflow

Response

Skills that do the task, best first.

query
string
required
results
SkillSearchHit · object[]
required
hint
string | null

What to do when nothing does this task exactly