Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Create a skill

Create a skill

Creates a vault skill from a key, name and SKILL.md content. Scripts are not persisted (see the install route notes).

POST/api/agent/skills
Body
vault_idstringrequired
keystringrequired
namestringrequired
descriptionstringrequired
contentstringrequired
tagsstring[]required
scriptsobject[]

Request

curl
curl -X POST https://trickest.io/api/agent/skills \
  -H "Authorization: Bearer $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200The new skill
skillobjectrequired

400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousAgent - SkillsList skillsAgent - SkillsNextGet a skill