veryfront__create_skillAccess
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. 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. |
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, 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 | 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 andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id | string | Yes | Unique identifier for the returned record. |
name | string | Yes | Human-readable name for the returned record. |
description | string | Yes | Human-readable description returned by the tool. |
source_path | string | Yes | |
edit_mode | string | Yes | Values: "structured", "source_only". |
allowed_tools | string[] | No | |
owner_agent_id | string | No | |
short_name | string | No | |
instructions | string | Yes | The Markdown body of SKILL.md, excluding frontmatter. |
sections | object | Yes | 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 | string | Yes | |
source_only_reasons | string[] | Yes | List of source only reasons associated with this tool result. |
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. 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#"
}
{
"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#"
}