Stacklok Registry Skills API
The registry-skills API from Stacklok — 2 operation(s) for registry-skills.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/stacklok-registry-skills-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: This is the ToolHive API server.
title: ToolHive Registry Skills API
version: '1.0'
tags:
- name: registry-skills
paths:
/registry/{registryName}/v0.1/x/dev.toolhive/skills:
get:
description: Get a paginated list of skills from the registry. Supports optional full-text search and pagination.
parameters:
- description: Registry name (currently ignored, uses the default provider)
in: path
name: registryName
required: true
schema:
type: string
- description: Search filter — matches against skill name, namespace, and description
in: query
name: q
schema:
type: string
- description: 'Page number, 1-based (default: 1)'
in: query
name: page
schema:
type: integer
- description: 'Items per page, max 200 (default: 50)'
in: query
name: limit
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.skillsV01Response'
description: OK
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.registryErrorResponse'
description: Internal server error
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.registryErrorResponse'
description: Registry authentication required or upstream registry unavailable
summary: List available registry skills
tags:
- registry-skills
operationId: getRegistryByRegistryNameV01XDevToolhiveSkills
x-operation-id-source: derived
/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{skillName}:
get:
description: Retrieve a single skill by its namespace and name from the registry.
parameters:
- description: Registry name (currently ignored, uses the default provider)
in: path
name: registryName
required: true
schema:
type: string
- description: Skill namespace in reverse-DNS format (e.g. io.github.stacklok)
in: path
name: namespace
required: true
schema:
type: string
- description: Skill name
in: path
name: skillName
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/registry.Skill'
description: OK
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.registryErrorResponse'
description: Skill not found
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.registryErrorResponse'
description: Internal server error
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/pkg_api_v1.registryErrorResponse'
description: Registry authentication required or upstream registry unavailable
summary: Get a registry skill
tags:
- registry-skills
operationId: getRegistryByRegistryNameV01XDevToolhiveSkillsByNamespaceBySkillName
x-operation-id-source: derived
components:
schemas:
registry.SkillPackage:
properties:
commit:
description: Commit is the commit of the package.
type: string
digest:
description: Digest is the digest of the package.
type: string
identifier:
description: Identifier is the OCI identifier of the package.
type: string
mediaType:
description: MediaType is the media type of the package.
type: string
ref:
description: Ref is the reference of the package.
type: string
registryType:
description: 'RegistryType is the type of registry the package is from.
Can be "oci" or "git".'
type: string
subfolder:
description: Subfolder is the subfolder of the package.
type: string
url:
description: URL is the URL of the package.
type: string
type: object
pkg_api_v1.paginationV01Metadata:
description: Metadata contains pagination information
properties:
limit:
description: Limit is the maximum number of items per page
type: integer
page:
description: Page is the current page number (1-based)
type: integer
total:
description: Total is the total number of items matching the query
type: integer
type: object
registry.SkillIcon:
properties:
label:
description: Label is the label of the icon.
type: string
size:
description: Size is the size of the icon.
type: string
src:
description: Src is the source of the icon.
type: string
type:
description: Type is the type of the icon.
type: string
type: object
registry.SkillRepository:
description: Repository is the source repository of the skill.
properties:
type:
description: Type is the type of the repository.
type: string
url:
description: URL is the URL of the repository.
type: string
type: object
pkg_api_v1.registryErrorResponse:
description: Structured error response returned by registry endpoints
properties:
code:
description: Code is a machine-readable error code (e.g. "not_found", "registry_auth_required")
type: string
message:
description: Message is a human-readable description of the error
type: string
type: object
registry.Skill:
properties:
_meta:
additionalProperties: {}
description: Meta is an opaque payload with extended meta data details of the skill.
type: object
allowedTools:
description: 'AllowedTools is the list of tools that the skill is compatible with.
This is experimental.'
items:
type: string
type: array
uniqueItems: false
compatibility:
description: Compatibility is the environment requirements of the skill.
type: string
description:
description: Description is the description of the skill.
type: string
icons:
description: Icons is the list of icons for the skill.
items:
$ref: '#/components/schemas/registry.SkillIcon'
type: array
uniqueItems: false
license:
description: License is the SPDX license identifier of the skill.
type: string
metadata:
additionalProperties: {}
description: 'Metadata is the official metadata of the skill as reported in the
SKILL.md file.'
type: object
name:
description: 'Name is the name of the skill.
The format is that of identifiers, e.g. "my-skill".'
type: string
namespace:
description: 'Namespace is the namespace of the skill.
The format is reverse-DNS, e.g. "io.github.user".'
type: string
packages:
description: Packages is the list of packages for the skill.
items:
$ref: '#/components/schemas/registry.SkillPackage'
type: array
uniqueItems: false
repository:
$ref: '#/components/schemas/registry.SkillRepository'
status:
description: 'Status is the status of the skill.
Can be one of "active", "deprecated", or "archived".'
type: string
title:
description: 'Title is the title of the skill.
This is for human consumption, not an identifier.'
type: string
version:
description: '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.'
type: string
type: object
pkg_api_v1.skillsV01Response:
description: Paginated list of skills from the registry
properties:
metadata:
$ref: '#/components/schemas/pkg_api_v1.paginationV01Metadata'
skills:
description: Skills is the list of skills on the current page
items:
$ref: '#/components/schemas/registry.Skill'
type: array
uniqueItems: false
type: object
externalDocs:
description: ''
url: ''