API reference / Skills
Add a skill pack
Adds a pack of skills from a public GitHub repository, on at once, at the commit its default branch is at. Each skill is a folder with a SKILL.md. Its skills become instructions for every teammate: add only repositories you trust. A workspace adds 20 packs at most, and adds or syncs 10 an hour. Needs an owner or admin.
/api/v1/skill-packsOther ways to call it
troopy packs addIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonurl*stringThe repository, like https://github.com/owner/repo
At least 3 characters · At most 300 characters
folderstringThe folder that holds the skill folders, like skills/marketing. Leave it out to find it
At most 200 characters
Response
200 · application/jsondata*object14 properties
key*stringThe pack, as owner__repo of its GitHub repository, like coreyhaines31__marketingskills
At most 150 characters
name*stringThe repository's name, like marketingskills
repo*stringowner/repo on GitHub
folder*stringThe folder of the repository that holds the skill folders, or several folders apart by commas; empty for the top
sha*stringThe commit that the pack reads
builtIn*booleanShips with Troopy: it follows Troopy's updates, and can't be removed
enabled*booleanOn: every teammate sees its skills that are on
author*stringlicense*string | nullThe SPDX id of its license, like MIT
stars*integer | nullIts stars on GitHub when it was added or synced
about*stringskills*array<object>4 properties
name*stringThe skill's name, like cold-email: a message that starts with /cold-email asks a teammate to use it
At most 64 characters
description*stringon*booleanTeammates see it: the pack is on, and nobody turned the skill off, and no skill before it has its name
shadowed*booleanOff because a skill of the workspace, or of a pack before it, has its name
warnings*array<string>What Troopy left out when it read the pack, and why
syncedAt*string | null