Get Skill Revision

GET

/skills/:skill_id/revisions/:revision_id

GET

/api/v1/skills/:skill_id/revisions/:revision_id

curl https://app.rightbrain.ai/api/v1/skills/skill_id/revisions/revision_id \
     -H "Authorization: Bearer <token>"

{
  "id": "019d6a01-2b20-7002-9c2b-3b6cad5f1002",
  "skill_id": "019d6a01-2b20-7001-9c2b-3b6cad5f1001",
  "instructions": "## When to use this skill\nUse this skill for 3P updates, company newsletters, FAQ responses and\nleadership updates.\n\n## How to use this skill\n1. Identify the communication type from the request.\n2. Load the matching reference file.\n3. Draft the communication in that format.\n",
  "skill_metadata": {},
  "capabilities": null,
  "annotation": "Imported from anthropics/skills",
  "created": "2026-03-25T14:47:34Z",
  "reference_files": [
    "3p-updates",
    "company-newsletter",
    "faq-answers",
    "general-comms"
  ],
  "asset_files": [],
  "reference_file_contents": [
    {
      "path": "3p-updates",
      "content": "Write a 3P update as three sections: Progress, Plans, Problems.\n",
      "size_bytes": 64,
      "size_kb": 0.06
    },
    {
      "path": "company-newsletter",
      "content": "Open with the single most important update, then three sections.\n",
      "size_bytes": 65,
      "size_kb": 0.06
    },
    {
      "path": "faq-answers",
      "content": "Answer in two sentences, then link the source of record.\n",
      "size_bytes": 57,
      "size_kb": 0.06
    },
    {
      "path": "general-comms",
      "content": "Lead with the decision, then the reason, then what changes.\n",
      "size_bytes": 60,
      "size_kb": 0.06
    }
  ],
  "asset_file_contents": [],
  "script_files": []
}

Retrieve full content for a specific skill revision, including structured reference and asset file bodies with size metadata.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

skill_idstringRequiredformat: "uuid"

revision_idstringRequiredformat: "uuid"

Response

Skill revision content

idstringformat: "uuid"

skill_idstringformat: "uuid"

instructionsstring

skill_metadatamap from strings to any or null

capabilitiesobject or null

annotationstring or null

createdstring

reference_fileslist of strings

asset_fileslist of strings

reference_file_contentslist of objectsOptional

asset_file_contentslist of objectsOptional

script_fileslist of stringsOptionalDefaults to []

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error