Skip to main content
GET
Get Skill Card

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Path Parameters

hub_id
string
required
card_id
string
required

Response

Successful Response

A single skill listing on a hub.

Unlike an :class:MCPCard there is nothing to configure: installing a skill copies its files into the workspace, so no input form and no template substitution are involved.

:attr:id addresses the card on its hub — together with :attr:hub_id it names the card globally; :attr:name is the skill's own name.

hub_id
string
required

The id of the hub this card came from.

name
string
required

The skill name.

id
string
default:""

The identifier addressing this card on its hub. Defaults to name for registries that expose no separate id.

description
string
default:""

The user-facing description of the skill.

display_name
string | null

The user-facing name, falling back to name.

tags
string[]

The tags categorizing this card.

version
string | null

The card version reported by the hub.

updated_at
number | null

The last-updated timestamp (Unix epoch seconds).

author
string | null

Who published the skill, when the hub says.

icon_url
string | null

An image representing the skill, for the card and the detail view. None when the hub offers none — the UI is expected to fall back rather than show a broken image.

installs
integer | null

How many times this skill has been installed. None when the hub does not count installs, which is not the same as zero — render it only when set.

downloads
integer | null

How many times this skill has been downloaded. None when the hub does not count downloads.

url
string | null

The skill's page on the hub's website, for a 'view on the hub' link. None when the hub has no web presence.

markdown
string | null

The SKILL.md body. Left None when browsing so the catalog does not fetch one file per card; populated by get_skill.

metadata
Metadata · object

The hub-specific extra fields carried verbatim.