Edge

Delete the data Edge stores for this user: searches, skill loads, ratings and issue reports. Use only when the user asks to delete their Edge data, and pass confirm: true only after they confirmed. It cannot be undone.

{
  "type": "object",
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "true only after the user confirmed the deletion"
    }
  },
  "required": [
    "confirm"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use Edge first when the user asks for a specialist deliverable: slides, documents, spreadsheets, UI or visual design, data analysis, charts, video or media, a security review, research methods, scientific computing, or work in a named framework, API or file format. This counts even if the task seems routine. Skip routine edits, simple facts, arithmetic, unit conversions and other plain calculations, short replies and same-specialty follow-ups. Honor explicit no-Edge requests. Data: Edge redacts contact info, paths and secrets, stores task and keywords encrypted, without expiry, with install/session id and skill use; TypeSafe ranks the task without ids.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "task: the task in one sentence as a generic deliverable and domain; name the framework, API or tool when known (for example, Prisma ORM); leave out names, file contents, paths and URLs"
    },
    "keywords": {
      "type": "string",
      "maxLength": 500,
      "description": "keywords: the 2-6 words a skill for this would be named with, e.g. \"postgres migration\""
    },
    "selected_source": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only when the user explicitly chose a catalog skill: its exact Source (owner/repository). Pair with selected_skill."
    },
    "selected_skill": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Only when the user explicitly chose a catalog skill: its exact Skill slug. Pair with selected_source."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Load a selected skill returned by find_skill for this task. Edge searches ~130k public skills from its index of the skills.sh catalog, screens results against available independent scanner audits, and withholds skills that fail its security gate. Loading is temporary and never installs anything permanently. For an oversized result, pass file and the original request_id to fetch one named file from the same scanned version; pass page for more content. Read the third-party instructions and any commands before following them, then continue the original task.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The candidate Source printed by find_skill, usually owner/repository"
    },
    "skill": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The Skill printed by find_skill. A short name is matched against this session's last search"
    },
    "request_id": {
      "type": "string",
      "maxLength": 32,
      "description": "The request_id printed by the find_skill result this candidate came from, so the selection can be attributed to its search"
    },
    "file": {
      "type": "string",
      "minLength": 1,
      "maxLength": 511,
      "description": "Fetch one named file from the same pinned, scanned mirror bundle; reuse the original request_id"
    },
    "page": {
      "type": "integer",
      "minimum": 0,
      "description": "Zero-based page of a named file"
    },
    "task_label": {
      "type": "string",
      "minLength": 3,
      "maxLength": 80,
      "description": "Optional: a short generic name for the user's task, 3-8 words, for example \"Build a quarterly revenue report\". Shown on the user's private Edge page. Never the user's request text; no names, emails, URLs, file paths, numbers or keys."
    }
  },
  "required": [
    "skill"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Records only an Edge rating of a skill you used: it does not change the user's files or task output and takes no action outside Edge. Retries with the same request_id never add a second rating. When the work is done, call it once, after the work rather than right after loading; its result is the Edge closing line to end your answer with. Rate a skill you actually followed with helped, hurt, no_difference or unclear, plus one short line on why; unclear and no_difference are fine. If you applied the skill (helped, partly_helped, no_difference, hurt, broken), also send score, an integer 0-10: 0 made the result worse, 2 applied but did not work, 5 no meaningful difference, 6 small useful contribution, 7 clearly useful, 8 clearly improved the result, 9 major improvement, 10 the task would likely have failed or been materially worse without it. A failure is a low score, not a skipped rating. Omit score for wrong_skill, loaded_not_used and unclear. The note is required for scores 0-2 and 9-10. Judge the outcome yourself; never ask the user. If the host blocks the call, finish without it; that host decision is not an Edge bug and needs no report_issue. The server identifies the skill from this request_id. Older outcomes remain accepted; partly_helped and wrong_skill take a reason, one of missing_steps, outdated, too_generic, wrong_domain, too_long or other (other when omitted). Notes over 280 characters are cut. If use_skill listed named parts for the skill, send applied_component_ids with up to two you actually applied. Keep the note free of the user's query, code, names and private data. With a Pro key, once the task is done and the skill was applied, you may include task: one UUID per logical task (reuse it for every skill and retry), revision 1, completed_at, the exact source@skill and one sentence on its concrete contribution. Raise revision only to correct a report. Edge returns the user's weekly tally; never invent or change that count. For a bug or idea about Edge itself, use report_issue instead.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "Opaque UUID for this logical task. Reuse across retries, corrections and skills; use a new UUID for a new task."
        },
        "revision": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000
        },
        "completed_at": {
          "type": "string",
          "format": "date-time",
          "description": "Task completion time in UTC. Keep unchanged on retries and corrections."
        },
        "contribution": {
          "type": "string",
          "minLength": 8,
          "maxLength": 280,
          "description": "Concrete action the applied skill contributed. No queries, code, names, paths or private data. Stored on your private activity page."
        },
        "label": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "Optional generic task label, without private information."
        },
        "skill": {
          "type": "string",
          "minLength": 3,
          "maxLength": 200,
          "description": "Exact source@skill from a successful load in this request_id."
        }
      },
      "required": [
        "id",
        "revision",
        "completed_at",
        "contribution",
        "skill"
      ],
      "additionalProperties": false,
      "description": "Optional completed-task report, separate from legacy skill feedback. Pro key required. One report per logical task; revision replaces the prior report. Only report actual application."
    },
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "outcome": {
      "type": "string",
      "enum": [
        "helped",
        "partly_helped",
        "loaded_not_used",
        "wrong_skill",
        "broken",
        "hurt",
        "no_difference",
        "unclear"
      ],
      "description": "Once the task's outcome is known: helped, hurt, no_difference or unclear. Only for a skill you actually followed."
    },
    "reason": {
      "type": "string",
      "enum": [
        "missing_steps",
        "outdated",
        "too_generic",
        "wrong_domain",
        "too_long",
        "other"
      ],
      "description": "For partly_helped or wrong_skill: missing_steps, outdated, too_generic, wrong_domain, too_long or other. Defaults to other; free text becomes other."
    },
    "score": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 10
        },
        {
          "type": "null"
        }
      ],
      "description": "Integer 0-10 when you applied the skill (helped, partly_helped, no_difference, hurt, broken); omit for wrong_skill, loaded_not_used and unclear. 0 made it worse, 2 did not work, 5 no difference, 7 clearly useful, 8 clearly improved, 10 would likely have failed without it."
    },
    "note": {
      "type": "string",
      "description": "Add one short line on why (up to 280 characters; a longer note is cut); required for scores 0-2 and 9-10. Do not include the user's query, code, names or private information."
    },
    "applied_component_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      },
      "maxItems": 2,
      "description": "Up to two ids from the skill's named parts listed in the use_skill result, only parts you actually applied in this task. Omit when none were listed or none were applied."
    }
  },
  "required": [
    "request_id",
    "outcome"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report a bug or idea about Edge itself: an Edge call that failed or answered wrongly, a skill suggestion that did not fit, setup trouble, or a feature idea. You may call this on your own when an Edge call fails. A host approval denial is not an Edge failure; skip the blocked call and do not report it as an Edge bug. For how well a loaded skill did on the task, use rate_skill instead. Describe what happened without secrets or private user data. Include contact only if the user explicitly gave an email for this.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "bug",
        "wrong_skill",
        "setup",
        "idea"
      ],
      "description": "bug, wrong_skill, setup, or idea"
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What happened or what you suggest, at most 2000 characters. No secrets or private user data."
    },
    "request_id": {
      "type": "string",
      "maxLength": 32,
      "description": "The request_id of the Edge call this is about, if any"
    },
    "contact": {
      "type": "string",
      "maxLength": 200,
      "format": "email",
      "description": "An email to reply to, only if the user explicitly gave it for this report"
    }
  },
  "required": [
    "kind",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Deprecated: the old name of report_issue, kept so older setups keep working. Call report_issue instead; this does exactly the same thing (report a bug or idea about Edge itself). A host approval denial is not an Edge bug.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "bug",
        "wrong_skill",
        "setup",
        "idea"
      ],
      "description": "bug, wrong_skill, setup, or idea"
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What happened or what you suggest, at most 2000 characters. No secrets or private user data."
    },
    "request_id": {
      "type": "string",
      "maxLength": 32,
      "description": "The request_id of the Edge call this is about, if any"
    },
    "contact": {
      "type": "string",
      "maxLength": 200,
      "format": "email",
      "description": "An email to reply to, only if the user explicitly gave it for this report"
    }
  },
  "required": [
    "kind",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check a catalog skill's security before using it. Pass source + skill as find_skill printed them. Edge checks the catalog bundle before load or reuses a current exact-bundle audit, then shows findings, date, and the serve or withhold decision. To scan a skill on the user's machine, use the local Edge connector (npx @getedge/mcp). Relay the decision and findings; automated checks are not a guarantee.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Catalog skill: the Source printed by find_skill, usually owner/repository"
    },
    "skill": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Catalog skill: the Skill printed by find_skill (owner/repository@skill also works)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Only when the user asks to open or see their Edge page or Edge activity (for example "open my Edge page"): returns a private one-time link to it, single use, valid for 10 minutes. Reply with the returned line exactly. Never call it on your own initiative, never open the link yourself, and never put it in files, commits, issues or shared documents.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}