Create Project Skill

POST

/org/:org_id/project/:project_id/skill

POST

/api/v1/org/:org_id/project/:project_id/skill

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/skill \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "display_name": "Code Review Assistant",
>   "instructions": "string"
> }'

1 {
2   "id": "string",
3   "slug": "string",
4   "display_name": "string",
5   "description": "string",
6   "license": "string",
7   "compatibility": "string",
8   "source": {
9     "id": "string",
10     "name": "string",
11     "description": "string",
12     "url": "string"
13   },
14   "tags": [
15     "string"
16   ],
17   "has_active_revision": true,
18   "has_capabilities": true,
19   "requires_prerequisites": true,
20   "active_revision": {
21     "id": "string",
22     "annotation": "string",
23     "created": "string"
24   },
25   "created": "string",
26   "modified": "string",
27   "project_id": "string",
28   "created_by_user_id": "string"
29 }

Create a project-scoped skill and its initial active revision in a single transaction.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Request

This endpoint expects an object.

display_namestringRequired<=255 characters

Human-readable name of the skill.

instructionsstringRequired

The primary instructions for this skill.

descriptionstring or nullOptional<=1024 characters

Short description shown in the skill catalog.

licensestring or nullOptional<=255 characters

Optional license string for the skill.

compatibilitystring or nullOptional<=500 characters

Optional compatibility notes for the skill.

slugstring or nullOptional

Stable lowercase kebab-case identifier for the skill.

reference_docsmap from strings to strings or nullOptional

Optional named reference files bundled with the skill.

assetsmap from strings to strings or nullOptional

Optional named asset files bundled with the skill.

skill_metadatamap from strings to any or nullOptional

Optional ADK skill metadata for the initial revision.

capabilitiesobject or nullOptional

Optional typed capability contract for the initial revision.

Response

Project skill created

idstringformat: "uuid"

slugstring

display_namestring

descriptionstring or null

licensestring or null

compatibilitystring or null

sourceobject

tagslist of strings

has_active_revisionboolean

has_capabilitiesboolean

requires_prerequisitesboolean

active_revisionobject or null

createdstring

modifiedstring

project_idstringformat: "uuid"

created_by_user_idstring or nullformat: "uuid"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error