API reference
Custom skills
CRUD endpoints for @alias skills. Author-only writes; workspace-wide reads.
#The CustomSkill object
| Field | Type | Description |
|---|---|---|
| id | string | skill_xxx |
| workspaceId | string | |
| alias | string | Used after @ in chat. Lowercase + hyphenated. |
| title | string | |
| description | string | |
| kind | "critique" | "augmenter" | |
| systemPrompt | string | The LLM instructions. |
| sampleArgs | string | null | |
| tags | string[] | |
| authorUserId | string | The user who created it. Only this user can update or delete. |
| createdAt | ISO 8601 | |
| updatedAt | ISO 8601 |
#List custom skills
GET/v1/custom-skills
#Get one
GET/v1/custom-skills/:id
#Create
POST/v1/custom-skills
Required fields: alias, title, description, kind, systemPrompt. alias must be unique within the workspace.
curl https://api.promptfloe.com/v1/custom-skills \
-H "Authorization: Bearer $PROMPTFLOE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"alias": "brand-voice",
"title": "Brand voice review",
"description": "Reviews copy for tone-of-voice fit",
"kind": "critique",
"systemPrompt": "..."
}'#Update
PATCH/v1/custom-skills/:id
Author only. Returns 403 for non-authors. Partial updates allowed — pass only the fields to change.
#Delete
DELETE/v1/custom-skills/:id
Author only. Hard-delete.
#Where to go next
PromptFloe developer docs