Sharebench

Search this workspace's published artifacts (skills, agents, workflows, and knowledge documents in SKILL.md format). Returns ranked metadata — name, description, type, contributor, timestamps, bundledCount, slug, authorCredit, and industries — but NOT the full body. To read an artifact's content, call `get_by_id` with the returned `artifactId` (or `slug`), or read it as a resource at `artifact://<artifactId>`. Use this whenever the user wants to find, discover, browse, or filter existing artifacts before reading or contributing. Modes: `hybrid` (default; combines lexical and semantic ranking via reciprocal rank fusion — best for most queries), `bm25` (exact-keyword or name lookups), `semantic` (concept matching when the user's terms differ from artifact text). Pass `industries: ['marketing', 'legal']` to narrow results to artifacts tagged with ANY of those industries (keyword-array overlap). If hybrid silently degrades because the embedding service is unavailable, the response's `warnings` array will contain `embedding_degraded:hybrid-fell-back-to-bm25` — surface this to the user if precision matters.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Free-text query. Names, phrases, or natural-language concepts."
    },
    "mode": {
      "type": "string",
      "enum": [
        "hybrid",
        "bm25",
        "semantic"
      ],
      "description": "Ranking strategy. Default: hybrid."
    },
    "type": {
      "type": "string",
      "enum": [
        "skill",
        "agent",
        "workflow",
        "knowledge"
      ],
      "description": "Filter by artifact category. Omit for all types."
    },
    "industries": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "maxItems": 5,
      "description": "Filter to artifacts tagged with ANY of these industry slugs (keyword-array overlap). Up to 5 values."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum hits to return. Default: 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset for navigating result sets."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Fetch the full SKILL.md content and metadata for a single artifact. Provide EXACTLY ONE of `artifactId` (the UUID returned by `search`) or `slug` (the URL-safe identifier, e.g. from a `/p/<slug>` link). Passing both or neither returns a `validation_failed` error. Use this after `search` to retrieve the body of a hit the user wants to read, summarize, apply, or fork. Returns the artifact's name, description, type, contributor, version, timestamps, the full SKILL.md text (YAML frontmatter + markdown body, up to 256 KB), the number of bundled extras (`bundledCount`), their filenames (`bundledFilenames`), per-file metadata in `bundledFiles` (each entry has `key`, `filename`, and `originalRef` — the EXACT body-relative reference string the importer matched, or `null` when the file was bundled without a body reference; use this to translate a link span in the body back to its bundle filename), and the public-surface fields `slug`, `authorCredit`, `industries`. To fetch a bundled extra, read it as a resource at `artifact://<artifactId>/bundled/<filename>`.

{
  "type": "object",
  "properties": {
    "artifactId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the artifact. Take this from the `artifactId` field of a `search` result. Mutually exclusive with `slug`."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
      "description": "URL slug for the artifact (e.g. `brand-voice`). Take this from the `slug` field of a `search` result or a /p/<slug> link. Mutually exclusive with `artifactId`."
    }
  },
  "additionalProperties": false
}