runx

Find runx skills by what they do. Returns each match with its skill id, owner, description, latest version, and trust tier, so a caller can pick one and then read it in full with get_skill.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the skill should do, in plain words. An empty string browses everything."
    },
    "limit": {
      "description": "Maximum matches to return.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read one runx skill in full before running it: its manifest, the authority it asks for, its publisher and trust signals, and the exact command to install and run it through the runx CLI. Everything needed to decide whether to trust a skill arrives in this one call.

{
  "type": "object",
  "properties": {
    "skill_id": {
      "type": "string",
      "minLength": 1,
      "description": "Skill id in owner/name form, for example `ausca/browser-session`."
    },
    "version": {
      "description": "Exact version to read. Defaults to the latest published version.",
      "type": "string"
    }
  },
  "required": [
    "skill_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}