---
title: "Browse Skill Catalog"
method: GET
path: "/skills/catalog"
tags: ["SKILLS"]
---

# Browse Skill Catalog

`GET /skills/catalog`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/skills/catalog`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List the skills published in Altimate's skill repos.

Declared ahead of ``/{public_id}`` so that "catalog" is routed here rather
than being read as a skill identifier.

Each entry carries ``imported_public_id`` when the caller already imported
it, so the Browse list can link to their copy instead of offering a second
import. That is matched on the upstream repo and path, not the name, so it
survives the user renaming their copy.

## Response `200`

Successful Response

- SkillCatalogResponse
  - `commit_sha` string, required
  - `groups` CatalogGroup[], required
    - `name` string, required
    - `description` string, required
    - `skills` CatalogSkill[], required
      - `repo` string, required
      - `public` boolean, required
      - `commit_sha` string, required
      - `catalog_id` string, required
      - `slug` string, required
      - `summary` string, required
      - `description` string, required
      - `file_count` integer
      - `size` integer, required
      - `imported_public_id` string, nullable

## Other responses

- `503`: Catalog unreachable

## Changes

- **2026-10-30** `77a7dface13f`: 3 info
  - added the required property `groups/items/skills/items/commit_sha` to the response with the `200` status
  - added the required property `groups/items/skills/items/public` to the response with the `200` status
  - added the required property `groups/items/skills/items/repo` to the response with the `200` status
- **2026-09-02** `fcb62c79da95`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/skills/catalog/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)