Skip to content

Import Skill Collection from GitHub

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

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

Parameters

Path Parameters

organisation
required
string

The organisation ID

Request Body required

object
namespace
required
string
/^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/
superpowers
source
required
object
type
required
string
Allowed values: github
repo
required
string
obra/superpowers
path
string
skills
version
string
main
tags
Array<string>
installedBy
string

Responses

201

Collection imported successfully

object
namespace
string
imported
integer
failed
integer
skills
Array<object>
object
errors
Array<object>
object

400

Invalid request parameters

403

Access denied

500

Failed to import collection

502

GitHub API error