Skip to main content
POST
Submit Skill

Submit Skill

Submit a new skill for moderation.

Endpoint

POST /agent/skill/submit-skill

Headers

Request Body

Server-side Defaults and Mapping

On submit, server writes to mk_ai_agent_skill with:
  • review_status = 1
  • difficulty_level = 2
  • category = 2
  • skill_code = UUID generated by system
  • upload_user_id parsed from Authorization API key (mk_ai_agent_api_key.user_id)
  • author from mk_user.nick_name by upload_user_id

Example

Response Example

Authorizations

Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
skillName
string
required

Skill name

Maximum string length: 100
description
string
required

Skill description

Maximum string length: 1000
version
string

Version string (default: 1.0.0)

Maximum string length: 50
howItWorks
string

How the skill works

clawhubUrl
string

ClawHub URL

Maximum string length: 255
githubUrl
string

GitHub repository URL

Maximum string length: 255

Response

200 - application/json

Submission result

skillCode
string

Generated skill code (UUID)

skillName
string
reviewStatus
integer

1=pending