SkillCatalogEntry

One typed-invocable shortcut spelling. A plugin skill may contribute two rows: its bare-name winner and its qualified <pluginId>:<skillId> form.

Fields and variants

• argumentHint
• description
• displayName
• pluginId
• selector
• source
• title

Source

schema/msp/experimental/msp.schema.json#/types/SkillCatalogEntry

{
  "description": "One typed-invocable shortcut spelling. A plugin skill may\ncontribute two rows: its bare-name winner and its qualified\n`<pluginId>:<skillId>` form.",
  "properties": {
    "argumentHint": {
      "description": "Present when the skill declares an argument hint.",
      "type": "string"
    },
    "description": {
      "description": "The skill's palette summary.",
      "type": "string"
    },
    "displayName": {
      "description": "The skill display name the first-party palette shows.",
      "type": "string"
    },
    "pluginId": {
      "description": "The owning plugin's identifier; present when `source` is `plugin`.",
      "type": "string"
    },
    "selector": {
      "description": "The shortcut token without the leading slash — bare (`fix-bug`) or\nplugin-qualified (`acme:deploy`) — the exact value a `skill` input\npart submits. Unique within one response.",
      "type": "string"
    },
    "source": {
      "$ref": "#/$defs/SkillSource",
      "description": "Where the skill comes from."
    },
    "title": {
      "description": "The skill's declared human-readable name (`SKILL.md`\n`metadata.display-name`), for clients to show where people read the\nskill's name; absent when the skill declares none (ADR 56597 D2). The\npalette keeps showing `displayName`.",
      "type": "string"
    }
  },
  "required": [
    "description",
    "displayName",
    "selector",
    "source"
  ],
  "type": "object"
}