Skills
4 operations. {prefix} is the route prefix passed to
MapAgentPrism; the template uses /agentprism.
GET {prefix}/api/skills
Section titled “GET {prefix}/api/skills”Operation ID: AgentPrismListSkills
Lists the tenant’s skills.
Skills are scoped to the calling tenant; a skill defined for another tenant is never returned. Each entry is complete — instructions, resources, and scripts come with it, so a client does not need a second call per skill. The response is not paged.
Authorization: bearer authentication; Reader role policy when that policy is registered; AgentsRead API-key scope.
| Response | Body | Headers |
|---|---|---|
| 200 OK | application/json → array of AgentSkillDefinition |
— |
GET {prefix}/api/skills/{name}
Section titled “GET {prefix}/api/skills/{name}”Operation ID: AgentPrismGetSkill
Returns a single skill and its resources.
The response carries the skill’s instructions together with every resource and script attached to it, including their content. Names are compared exactly, case included; an unknown name returns 404.
Authorization: bearer authentication; Reader role policy when that policy is registered; AgentsRead API-key scope.
| Parameter | In | Required | Type | Description and rules |
|---|---|---|---|---|
name |
path | yes | string |
— |
| Response | Body | Headers |
|---|---|---|
| 200 OK | application/json → AgentSkillDefinition |
— |
PUT {prefix}/api/skills/{name}
Section titled “PUT {prefix}/api/skills/{name}”Operation ID: AgentPrismSaveSkill
Creates or updates a skill.
The call replaces the whole skill: resources and scripts that the body omits are removed. A first save answers 201, a later one 200. The path name and the body name must be identical (400 otherwise). Name, description, and compatibility follow the skill frontmatter rules, and instructions, resources, and scripts are each bounded by the configured size limits. A script may be SAVED even when script execution is turned off — saving and running are separate permissions — but an extension with no registered interpreter is rejected, because such a script could never run and would leave dead data behind.
Authorization: bearer authentication; Admin role policy when that policy is registered; AgentsAdmin API-key scope.
| Parameter | In | Required | Type | Description and rules |
|---|---|---|---|---|
name |
path | yes | string |
— |
Request body (required):
application/json→AgentSkillRequest
| Response | Body | Headers |
|---|---|---|
| 200 OK | application/json → AgentSkillDefinition |
— |
| 201 Created | application/json → AgentSkillDefinition |
— |
DELETE {prefix}/api/skills/{name}
Section titled “DELETE {prefix}/api/skills/{name}”Operation ID: AgentPrismDeleteSkill
Deletes a skill and its cascading resources.
Resources and scripts are removed with the skill. Agent definitions that still name the skill are NOT rewritten, and they stop resolving: compiling such an agent fails with ‘the skill was not found’ until the reference is removed or the skill is recreated. Check the agents that use a skill before deleting it. An unknown name returns 404.
Authorization: bearer authentication; Admin role policy when that policy is registered; AgentsAdmin API-key scope.
| Parameter | In | Required | Type | Description and rules |
|---|---|---|---|---|
name |
path | yes | string |
— |
| Response | Body | Headers |
|---|---|---|
| 204 No Content | — | — |