Update skill

veryfront__update_skill

skill_id is REQUIRED and is the skill 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 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. Omitting it leaves the existing body untouched; sending it replaces the whole body. Use str_replace to replace one exact occurrence in the current instructions. Do not combine it with instructions. The former sections object is no longer part of this tool and is rejected if sent. Use instructions instead. A skill cannot be renamed: name, when sent, must equal skill_id. There is no display_name field.

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
`skill_id`	`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`.
`name`	`string`	No	Optional; when sent it must equal `skill_id`. 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	Optional. Full markdown body of SKILL.md. Omit it to leave the existing body untouched; send it to replace the body wholesale.
`str_replace`	`object`	No	Replace one exact occurrence in the current instructions. Do not combine with instructions.
`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__update_skill",
    "arguments": {
      "skill_id": "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"
    },
    "skill_id": {
      "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."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "description": "Optional; when sent it must equal skill_id. 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": "Optional. Full markdown body of SKILL.md. Omit it to leave the existing body untouched; send it to replace the body wholesale."
    },
    "str_replace": {
      "type": "object",
      "properties": {
        "old_string": {
          "type": "string",
          "minLength": 1,
          "description": "Exact current text. It must match exactly once."
        },
        "new_string": {
          "type": "string",
          "description": "Replacement text. Use an empty string to delete the matched text."
        }
      },
      "required": [
        "old_string",
        "new_string"
      ],
      "additionalProperties": false,
      "description": "Replace one exact occurrence in the current instructions. Do not combine with instructions."
    },
    "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": [
    "skill_id",
    "description"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the update_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