API reference · schema

CreateSkillRequest

17 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`namespace` required	string	min length `2` · max length `64`
`name` required	string	min length `1` · max length `255`
`skill_type` required	string	procedural, tool_skill, workflow_skill, reasoning_skill, domain_skill, learned_skill, composite_skill, human_authored
`description`	string	default `""`
`content` required	string	min length `1`
`inputs`	object or null	default `{}`
`outputs`	object or null	default `{}`
`required_tools`	array of string or null	default `[]`
`required_actions`	array of string or null	default `[]`
`required_resources`	array of string or null	default `[]`
`required_identities`	array of string or null	default `[]`
`risk_level`	string	default `"medium"`
`test_code`	string or null
`dependencies`	array of string or null	default `[]`
`provenance`	object or null
`trace_id`	string or null
`trajectory_id`	string or null

Smallest valid example

{
  "namespace": "namespace",
  "name": "name",
  "skill_type": "skill-type",
  "description": "",
  "content": "content",
  "inputs": {},
  "outputs": {},
  "required_tools": [],
  "required_actions": [],
  "required_resources": [],
  "required_identities": [],
  "risk_level": "medium",
  "dependencies": []
}

Used by 1 operation

POST /fabric/skills Create Skill

JSON Schema

Show the raw definition

{
  "properties": {
    "namespace": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "title": "Namespace"
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "title": "Name"
    },
    "skill_type": {
      "type": "string",
      "title": "Skill Type",
      "description": "procedural, tool_skill, workflow_skill, reasoning_skill, domain_skill, learned_skill, composite_skill, human_authored"
    },
    "description": {
      "type": "string",
      "title": "Description",
      "default": ""
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "title": "Content"
    },
    "inputs": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Inputs",
      "default": {}
    },
    "outputs": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Outputs",
      "default": {}
    },
    "required_tools": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Required Tools",
      "default": []
    },
    "required_actions": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Required Actions",
      "default": []
    },
    "required_resources": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Required Resources",
      "default": []
    },
    "required_identities": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Required Identities",
      "default": []
    },
    "risk_level": {
      "type": "string",
      "title": "Risk Level",
      "default": "medium"
    },
    "test_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Test Code"
    },
    "dependencies": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dependencies",
      "default": []
    },
    "provenance": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance"
    },
    "trace_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trace Id"
    },
    "trajectory_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trajectory Id"
    }
  },
  "type": "object",
  "required": [
    "namespace",
    "name",
    "skill_type",
    "content"
  ],
  "title": "CreateSkillRequest"
}

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.

Create a free account → · Try the sandbox · See the whole ecosystem