openapi

OpenAPI 3.1 catalog.

Machine-readable skill catalog, REST endpoint reference, and authentication details for custom integrations that go beyond MCP.

Live spec

The catalog spec is generated server-side from the live database and updates every hour. It lists every published skill with its slug, name, summary, price, and a link to the per-skill OpenAPI spec.

GET · public · no auth required

https://skill.ski/openapi.json

Returns OpenAPI 3.1 JSON. Cache-Control: max-age=3600. No authentication required — this is the public catalog index. Private skill details require your bearer token.

Open live spec →

Spec structure (abbreviated)

{
  "openapi": "3.1.0",
  "info": {
    "title": "skil.ski skill catalog",
    "version": "1",
    "description": "Index of all published skills on skil.ski. Each path links to a per-skill OpenAPI spec. Invoke any skill at https://skill.ski/api/mcp with a Bearer token from /vault.",
    "x-delivery": "mcp"
  },
  "servers": [
    {
      "url": "https://skill.ski",
      "description": "skil.ski catalog root"
    }
  ],
  "paths": {
    "/skills/hvac-dispatch-scheduler/openapi.json": {
      "get": {
        "summary": "HVAC Dispatch Scheduler",
        "description": "Schedules and prioritizes HVAC service dispatch orders...",
        "x-price-usd": 199,
        "externalDocs": {
          "description": "Full OpenAPI spec for HVAC Dispatch Scheduler",
          "url": "https://skill.ski/skills/hvac-dispatch-scheduler/openapi.json"
        },
        "responses": {
          "200": { "description": "OpenAPI 3.1 spec for this skill" }
        }
      }
    }
  }
}

REST endpoints

These endpoints support catalog exploration and bounty management. All authenticated endpoints require a bearer token (same one used for MCP).

GET

/openapi.json

none

Full catalog OpenAPI 3.1 spec. Public. Updates hourly.

GET

/api/skills

optional

Paginated skill list. Supports ?sector=, ?verified=, ?tier=, ?q= (search), ?limit=, ?page=. Auth adds ownership and enable state.

GET

/api/skills/:slug

optional

Single skill detail. Auth adds vault ownership and enable status.

GET

/skills/:slug/openapi.json

none

Per-skill OpenAPI 3.1 spec with full input/output schema.

GET

/api/bounties

none

Open bounties. Supports ?status=open|claimed|fulfilled&limit=&page=.

POST

/api/bounties

required

Submit a new bounty. Body: { title, description, sector, budget_usd }.

Authentication

Authenticated REST endpoints use the same bearer token as the MCP endpoint. Generate your token in your SkiLodge.

Authenticated request example

GET https://skill.ski/api/skills/hvac-dispatch-scheduler
Authorization: Bearer sk_YOUR_TOKEN_HERE

Response 200:
{
  "slug": "hvac-dispatch-scheduler",
  "name": "HVAC Dispatch Scheduler",
  "owned": true,
  "enabled": true,
  "vault_added_at": "2026-04-22T09:15:00Z"
}

Example: `/api/skills`

Filter the catalog by sector, verification status, and tier. Pagination via limit and page.

Request + response

GET https://skill.ski/api/skills?sector=hvac-residential&verified=true&limit=20

Response 200:
{
  "skills": [
    {
      "slug": "hvac-dispatch-scheduler",
      "name": "HVAC Dispatch Scheduler",
      "sector": "hvac-residential",
      "tier": "pro",
      "price_usd": 199,
      "verified": true,
      "summary": "Schedules and prioritizes HVAC service dispatch orders...",
      "bottleneck": "Manual prioritization wastes 30-45 min per dispatcher per shift."
    }
  ],
  "total": 47,
  "page": 1
}

Example: `/api/bounties`

Browse open skill requests. Post a bounty to commission a skill for your workflow.

Request + response

GET https://skill.ski/api/bounties?status=open&limit=10

Response 200:
{
  "bounties": [
    {
      "id": "bnty_01hzxyz",
      "title": "Plumbing estimate generator for residential jobs",
      "sector": "plumbing-emergency",
      "budget_usd": 500,
      "status": "open",
      "created_at": "2026-04-20T14:30:00Z",
      "votes": 14
    }
  ],
  "total": 8,
  "page": 1
}

Tooling and SDKs

The OpenAPI spec can be loaded into any spec-compatible tool:

Postman

Import /openapi.json as a collection for manual testing.

openapi-fetch

TypeScript-first fetch wrapper with type inference from the spec.

Swagger UI

Render the spec in a hosted or local Swagger UI instance.

openapi-generator

Generate a typed client in Go, Python, Java, or any supported language.

Live spec (openapi.json) →MCP Protocol →Quickstart →

openapi

OpenAPI 3.1 catalog.

Machine-readable skill catalog, REST endpoint reference, and authentication details for custom integrations that go beyond MCP.

Live spec

The catalog spec is generated server-side from the live database and updates every hour. It lists every published skill with its slug, name, summary, price, and a link to the per-skill OpenAPI spec.

GET · public · no auth required

https://skill.ski/openapi.json

Returns OpenAPI 3.1 JSON. Cache-Control: max-age=3600. No authentication required — this is the public catalog index. Private skill details require your bearer token.

Open live spec →

Spec structure (abbreviated)

{
  "openapi": "3.1.0",
  "info": {
    "title": "skil.ski skill catalog",
    "version": "1",
    "description": "Index of all published skills on skil.ski. Each path links to a per-skill OpenAPI spec. Invoke any skill at https://skill.ski/api/mcp with a Bearer token from /vault.",
    "x-delivery": "mcp"
  },
  "servers": [
    {
      "url": "https://skill.ski",
      "description": "skil.ski catalog root"
    }
  ],
  "paths": {
    "/skills/hvac-dispatch-scheduler/openapi.json": {
      "get": {
        "summary": "HVAC Dispatch Scheduler",
        "description": "Schedules and prioritizes HVAC service dispatch orders...",
        "x-price-usd": 199,
        "externalDocs": {
          "description": "Full OpenAPI spec for HVAC Dispatch Scheduler",
          "url": "https://skill.ski/skills/hvac-dispatch-scheduler/openapi.json"
        },
        "responses": {
          "200": { "description": "OpenAPI 3.1 spec for this skill" }
        }
      }
    }
  }
}

REST endpoints

These endpoints support catalog exploration and bounty management. All authenticated endpoints require a bearer token (same one used for MCP).

GET

/openapi.json

none

Full catalog OpenAPI 3.1 spec. Public. Updates hourly.

GET

/api/skills

optional

Paginated skill list. Supports ?sector=, ?verified=, ?tier=, ?q= (search), ?limit=, ?page=. Auth adds ownership and enable state.

GET

/api/skills/:slug

optional

Single skill detail. Auth adds vault ownership and enable status.

GET

/skills/:slug/openapi.json

none

Per-skill OpenAPI 3.1 spec with full input/output schema.

GET

/api/bounties

none

Open bounties. Supports ?status=open|claimed|fulfilled&limit=&page=.

POST

/api/bounties

required

Submit a new bounty. Body: { title, description, sector, budget_usd }.

Authentication

Authenticated REST endpoints use the same bearer token as the MCP endpoint. Generate your token in your SkiLodge.

Authenticated request example

GET https://skill.ski/api/skills/hvac-dispatch-scheduler
Authorization: Bearer sk_YOUR_TOKEN_HERE

Response 200:
{
  "slug": "hvac-dispatch-scheduler",
  "name": "HVAC Dispatch Scheduler",
  "owned": true,
  "enabled": true,
  "vault_added_at": "2026-04-22T09:15:00Z"
}

Example: `/api/skills`

Filter the catalog by sector, verification status, and tier. Pagination via limit and page.

Request + response

GET https://skill.ski/api/skills?sector=hvac-residential&verified=true&limit=20

Response 200:
{
  "skills": [
    {
      "slug": "hvac-dispatch-scheduler",
      "name": "HVAC Dispatch Scheduler",
      "sector": "hvac-residential",
      "tier": "pro",
      "price_usd": 199,
      "verified": true,
      "summary": "Schedules and prioritizes HVAC service dispatch orders...",
      "bottleneck": "Manual prioritization wastes 30-45 min per dispatcher per shift."
    }
  ],
  "total": 47,
  "page": 1
}

Example: `/api/bounties`

Browse open skill requests. Post a bounty to commission a skill for your workflow.

Request + response

GET https://skill.ski/api/bounties?status=open&limit=10

Response 200:
{
  "bounties": [
    {
      "id": "bnty_01hzxyz",
      "title": "Plumbing estimate generator for residential jobs",
      "sector": "plumbing-emergency",
      "budget_usd": 500,
      "status": "open",
      "created_at": "2026-04-20T14:30:00Z",
      "votes": 14
    }
  ],
  "total": 8,
  "page": 1
}

Tooling and SDKs

The OpenAPI spec can be loaded into any spec-compatible tool:

Postman

Import /openapi.json as a collection for manual testing.

openapi-fetch

TypeScript-first fetch wrapper with type inference from the spec.

Swagger UI

Render the spec in a hosted or local Swagger UI instance.

openapi-generator

Generate a typed client in Go, Python, Java, or any supported language.

Live spec (openapi.json) →MCP Protocol →Quickstart →

OpenAPI 3.1 catalog.

Live spec

REST endpoints

Authentication

Example: /api/skills

Example: /api/bounties

Tooling and SDKs

OpenAPI 3.1 catalog.

Live spec

REST endpoints

Authentication

Example: /api/skills

Example: /api/bounties

Tooling and SDKs

Example: `/api/skills`

Example: `/api/bounties`

Example: `/api/skills`

Example: `/api/bounties`