Import Skill Collection from GitHub
POST /api/v3/organizations/{organisation}/ai/skills/import-collection
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
superpowers source
required
object
type
required
string
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