Create skill

veryfront__create_skill

name is REQUIRED: max 64 characters, lowercase letters, numbers, and hyphens only, must not start or end with a hyphen, and must not contain consecutive hyphens (e.g. “daily-changelog-flow”, not “daily—changelog”). description is REQUIRED: max 1024 characters, non-empty, describing what the skill does and when to use it. instructions is the full markdown body of SKILL.md, meaning everything below the frontmatter, written verbatim. Put the whole skill there, using any markdown headings you like. The former sections object is no longer part of this tool and is rejected if sent. Use instructions instead. There is no display_name field. name is the canonical skill identifier and its directory name, so put the human-readable label in description instead.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.

Arguments

Field	Type	Required	Description and constraints
`project_reference`	`string`	No	Project ID or slug
`name`	`string`	Yes	Required. Canonical skill name, also used as the skill directory name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens. Minimum length: `1`. Maximum length: `64`.
`id`	`string`	No	Deprecated alias for name; when sent it must equal name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens. Minimum length: `1`. Maximum length: `64`.
`description`	`string`	Yes	Required. Max 1024 characters. Non-empty. Describes what the skill does and when to use it. Minimum length: `1`. Maximum length: `1024`.
`allowed_tools`	`string[]`	No	The allowed tools associated with this record.
`instructions`	`string`	No	Full markdown body of SKILL.md, meaning everything below the frontmatter. Sending it replaces the whole body.
`source_target_kind`	`string`	No	The source target kind associated with this record.
`target_branch_id`	`string or null`	No	The target branch id associated with this record.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

request.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__create_skill",
    "arguments": {
      "name": "example",
      "description": "example"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

Field	Type	Required	Description and constraints
`id`	`string`	Yes	Unique identifier for the record.
`name`	`string`	Yes	Human-readable name for the record.
`description`	`string`	Yes	Human-readable description for the record.
`source_path`	`string`	Yes	The source path associated with this record.
`edit_mode`	`string`	Yes	The edit mode associated with this record. Values: `"structured"`, `"source_only"`.
`allowed_tools`	`string[]`	No	The allowed tools associated with this record.
`instructions`	`string`	Yes	Full markdown body of SKILL.md, meaning everything below the frontmatter. Sending it replaces the whole body.
`source`	`string`	Yes	The source associated with this record.
`source_only_reasons`	`string[]`	Yes	List of source only reasons associated with this record.

Full schemas

{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "description": "Required. Canonical skill name, also used as the skill directory name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens."
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "description": "Deprecated alias for name; when sent it must equal name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens."
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024,
      "description": "Required. Max 1024 characters. Non-empty. Describes what the skill does and when to use it."
    },
    "allowed_tools": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "One allowed tool item associated with this record."
      },
      "description": "The allowed tools associated with this record."
    },
    "instructions": {
      "type": "string",
      "description": "Full markdown body of SKILL.md, meaning everything below the frontmatter. Sending it replaces the whole body."
    },
    "source_target_kind": {
      "type": "string",
      "description": "The source target kind associated with this record."
    },
    "target_branch_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "description": "The target branch id associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the target branch id."
        }
      ],
      "description": "The target branch id associated with this record."
    }
  },
  "required": [
    "name",
    "description"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the create_skill tool."
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the record."
    },
    "description": {
      "type": "string",
      "description": "Human-readable description for the record."
    },
    "source_path": {
      "type": "string",
      "description": "The source path associated with this record."
    },
    "edit_mode": {
      "type": "string",
      "enum": [
        "structured",
        "source_only"
      ],
      "description": "The edit mode associated with this record."
    },
    "allowed_tools": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One allowed tool item associated with this record."
      },
      "description": "The allowed tools associated with this record."
    },
    "instructions": {
      "type": "string",
      "description": "Full markdown body of SKILL.md, meaning everything below the frontmatter. Sending it replaces the whole body."
    },
    "source": {
      "type": "string",
      "description": "The source associated with this record."
    },
    "source_only_reasons": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One source only reason item associated with this record."
      },
      "description": "List of source only reasons associated with this record."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "source_path",
    "edit_mode",
    "instructions",
    "source",
    "source_only_reasons"
  ],
  "additionalProperties": false,
  "description": "Structured skill output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get started

APIs

REST API

GraphQL API

MCP API

Access

Arguments

Example request

Result

Full schemas

​Access

​Arguments

​Example request

​Result

​Full schemas

Access

Arguments

Example request

Result

Full schemas