Submit Skill (Admin)

Create or update a partner skill submission in draft state. Returns Stage-1 lint inline. Requires an admin-scoped API key. Per spec §6.2, the response carries {submissionId, status: 'draft', validationSummary}.

Parameters

Name	Type	Default	Description
submissionId	string	-
name Required	string	-
slug Required	string	-
description Required	string	-
heroCopy Required	string	-
markdownBody Required	string	-
toolAllowlist	array	[]
marketingUseCases	array	[]
marketingUseCases[].title Required	string	-
marketingUseCases[].description Required	string	-
useCases	array	[]
meshCategory	string	-
screenshotUrl	string	-
version	integer	1
changelog	string	-

Use Cases

• Create a new partner skill submission in draft, with inline Stage-1 lint feedback
• Update an existing draft skill's markdown or tool allowlist (pass its submissionId)

Example Usage

Create a skill draft

{
  "tool": "admin_submit_skill",
  "arguments": {
    "name": "Competitive Teardown",
    "slug": "competitive-teardown",
    "description": "A skill that structures a competitor teardown.",
    "heroCopy": "Structure a competitor teardown in minutes.",
    "markdownBody": "# Competitive Teardown\nGather firmographics, spend, and intent, then summarize."
  }
}

Response Format

Field	Type	Description
submissionId	string | null	UUID of the created/updated submission. Null only on the pre-write slug_collision path (validationSummary carries a single slug_collision error).
status	string	Submission state after this call.
validationSummary	object	Stage-1 lint result (same shape as validate_submission output). Absent on the happy path when no issues surfaced.
validationSummary.status	string
validationSummary.issues	array
validationSummary.issues[].code	string	Stable issue code (ISSUE_CODES).
validationSummary.issues[].severity	string
validationSummary.issues[].field	string
validationSummary.issues[].message	string
validationSummary.issues[].fixHint	string	Actionable remediation hint for blocking issues.