v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0163155274.5 KB
registry-skills

Get a registry skill

Retrieve a single skill by its namespace and name from the registry.

get/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{skillName}

Path parameters

registryNamestring required

Registry name (currently ignored, uses the default provider)

namespacestring required

Skill namespace in reverse-DNS format (e.g. io.github.stacklok)

skillNamestring required

Skill name

Response

OK

_metaobject

Meta is an opaque payload with extended meta data details of the skill.

allowedToolsstring[]

AllowedTools is the list of tools that the skill is compatible with. This is experimental.

compatibilitystring

Compatibility is the environment requirements of the skill.

descriptionstring

Description is the description of the skill.

licensestring

License is the SPDX license identifier of the skill.

metadataobject

Metadata is the official metadata of the skill as reported in the SKILL.md file.

namestring

Name is the name of the skill. The format is that of identifiers, e.g. "my-skill".

namespacestring

Namespace is the namespace of the skill. The format is reverse-DNS, e.g. "io.github.user".

statusstring

Status is the status of the skill. Can be one of "active", "deprecated", or "archived".

titlestring

Title is the title of the skill. This is for human consumption, not an identifier.

versionstring

Version is the version of the skill. Any non-empty string is valid, but ideally it should be either a semantic version or a commit hash.