Skills
The /v1/skills resource — invoke critique skills and augmenters. The endpoints unify both kinds; the response shape differs by kind.
#List built-in skills
Returns every built-in skill grouped by pack. For workspace-scoped custom skills, see Custom skills.
#Run a skill
Streaming endpoint. Use the SDK's skills.run for one-shot collection or skills.runStream for live streaming.
| Field | Type | Description |
|---|---|---|
| aliasrequired | string | Skill alias without prefix. /roast → "roast". |
| appId | string | Run against an app you own. |
| chatId | string | Run within an existing chat. Result appears as a chat message. |
| url | string | Run against a public URL. |
| text | string | Run against raw text. |
| args | string | Free-form additional arguments. |
| dryRun | boolean | Augmenters only: run without writing files. |
| force | boolean | Augmenters only: ignore idempotency markers. |
#Run an augmenter
Sugar over /v1/skills/run that asserts the alias is an augmenter (returns 400 otherwise). Same request/response shape; recommended for client code that's specifically applying patches so the type signature is narrower.
curl https://api.promptfloe.com/v1/augmenters/run \
-H "Authorization: Bearer $PROMPTFLOE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"alias":"seo","appId":"app_abc"}'#Get a run
Returns the persisted record of a completed (or in-flight) run.
#Cancel a run
See Cancellation for the full guide including quota refund policy.
#Rollback an augmenter
Reverts an applied augmenter — restores the file states from before the run. Available for 24 hours after the run.