Import Skill Collection from GitHub

POST

/api/v3/organizations/{organisation}/ai/skills/import-collection

curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/skills/import-collection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "namespace": "superpowers", "source": { "type": "github", "repo": "obra/superpowers", "path": "skills", "version": "main" }, "tags": [ "example" ], "installedBy": "example" }'

• QuantCDN Public Cloud
• QuantGov Cloud

Discovers all skill directories under a given path in a GitHub repository * and imports each as a skill within the specified namespace. Each subdirectory must contain a SKILL.md file. * * Namespace: Used for grouping and slash-command invocation (e.g., /superpowers:brainstorming). * * Idempotent: If a skill with the same namespace + name already exists, it is updated.

Authorizations

• BearerAuth

Parameters

Path Parameters

organisation

required

string

The organisation ID

Request Body^required

Media typeapplication/json

object

namespace

required

string

/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/

Example

superpowers

source

required

object

type

required

string

Allowed values: github

repo

required

string

Example

obra/superpowers

path

string

Example

skills

version

string

Example

main

tags

Array<string>

installedBy

string

Responses

201

Collection imported successfully

Media typeapplication/json

object

namespace

string

imported

integer

failed

integer

skills

Array<object>

object

errors

Array<object>

object

Example^generated

{
  "namespace": "example",
  "imported": 1,
  "failed": 1,
  "skills": [
    {}
  ],
  "errors": [
    {}
  ]
}

400

Invalid request parameters

403

Access denied

500

Failed to import collection

502

GitHub API error