Skills

A Skill is a declarative, versioned ability an agent can activate. It loads instructions and reference material into model context instead of returning a tool result. A Skill revision can also declare registered-tool, Integration, MCP-server, and MCP-tool dependencies that are provisioned when the Skill is attached to an agent revision.

The API exposes two Skill scopes:

• Global Skills are read-only catalog entries available across Projects. Catalog endpoints list Skills, sources, tags, content, and revisions.
• Project Skills belong to one Project. Their endpoints create and update Skills, manage immutable revisions, activate a revision, and control direct access through Skill IAM.

Provisioning a declared dependency does not authorize its external service. Integration and MCP credentials are managed separately through Connections.

All endpoints require authentication. Project Skill endpoints are scoped to an Organization and Project; permission requirements are defined on each endpoint.

Key endpoints

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": "Refund Policy",
  "instructions": "Approve refunds requested within 30 days of purchase. Escalate anything older to finance.",
  "description": "How to decide whether a refund request qualifies."
}'

Related