Create skill

veryfront__create_skill

Requires project.agents.write.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
project_referencestringNoProject ID or slug
namestringYesRequired. Canonical skill name, also used as the skill directory name. For example "daily-changelog-flow", not "daily--changelog". A skill cannot be renamed. There is no display_name field; put the human-readable label in description. 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.
descriptionstringYesRequired. Max 1024 characters. Non-empty. Describes what the skill does and when to use it. Minimum length: 1. Maximum length: 1024.
allowed_toolsstring[]NoThe allowed tools associated with this record.
instructionsstringNoFull markdown body of SKILL.md, meaning everything below the frontmatter, written verbatim with any markdown headings. Sending it replaces the whole body. The former sections object is rejected; put the whole skill here.
source_target_kindstringNoThe source target kind associated with this record.
target_branch_idstring or nullNoThe 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.

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.

FieldTypeRequiredDescription and constraints
idstringYesUnique identifier for the returned record.
namestringYesHuman-readable name for the returned record.
descriptionstringYesHuman-readable description returned by the tool.
source_pathstringYes
edit_modestringYesValues: "structured", "source_only".
allowed_toolsstring[]No
owner_agent_idstringNo
short_namestringNo
instructionsstringYesThe Markdown body of SKILL.md, excluding frontmatter.
sectionsobjectYesRead-only sections derived from ## headings in the body. Empty if the body cannot be split into sections. Use instructions for the complete, authoritative body; this field cannot be updated.
sourcestringYes
source_only_reasonsstring[]YesList of source only reasons associated with this tool result.

Full schemas

json
{
  "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. For example \"daily-changelog-flow\", not \"daily--changelog\". A skill cannot be renamed. There is no display_name field; put the human-readable label in description. 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, written verbatim with any markdown headings. Sending it replaces the whole body. The former sections object is rejected; put the whole skill here."
    },
    "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,
  "description": "Structured create skill input schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the returned record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the returned record."
    },
    "description": {
      "type": "string",
      "description": "Human-readable description returned by the tool."
    },
    "source_path": {
      "type": "string"
    },
    "edit_mode": {
      "type": "string",
      "enum": [
        "structured",
        "source_only"
      ]
    },
    "allowed_tools": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "owner_agent_id": {
      "type": "string"
    },
    "short_name": {
      "type": "string"
    },
    "instructions": {
      "type": "string",
      "description": "The Markdown body of `SKILL.md`, excluding frontmatter."
    },
    "sections": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "description": "Additional structured values associated with this result."
      },
      "propertyNames": {
        "minLength": 1
      },
      "description": "Read-only sections derived from `## ` headings in the body. Empty if the body cannot be split into sections. Use `instructions` for the complete, authoritative body; this field cannot be updated."
    },
    "source": {
      "type": "string"
    },
    "source_only_reasons": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of source only reasons associated with this tool result."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "source_path",
    "edit_mode",
    "instructions",
    "sections",
    "source",
    "source_only_reasons"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the create_skill tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}