Skills
Prompt presets you can attach to a question.
A skill is a saved instruction you can attach to a question — a tone, a format, a role for the model to answer in.
What a skill is
Each skill carries a core_prompt that gets appended to the system prompt for that one generation. It changes how the question is answered; it does not change what can be retrieved.
Scope
Skills are defined at one of three levels:
- Global — provided by the platform for a vertical, and read-only.
- Application — authored in your app, usable from every workspace under it.
- Workspace — authored for one workspace, usable only there.
The list endpoint returns the union of workspace-scoped and app-scoped skills, so what you get back is exactly what that workspace may use. A skill_id from another app is rejected rather than silently ignored.
Using one
Fetch the list, offer the titles as options, and pass the chosen id as skill_id when you send a message. Skills are optional decoration: a chat works identically without one, so never make the list a precondition for asking a question.
curl "https://api.daneshyar.info/api/v1/workspaces/8f14e45f-ceea-467a-9f4c-1a2b3c4d5e6f/skills/" \
-H "X-API-Key: dk_live_9f3aC2xQ7mB1vT8sE4nK6pR0jY5wZ2hL"