Skip to main content

​
Submit Skill

Submit a new skill for moderation.

​
Endpoint

POST /agent/skill/submit-skill

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer API_KEY_CODE

​
Request Body

FieldTypeRequiredDescription
skillNamestringYesSkill name, max 100 chars
versionstringNoVersion, default 1.0.0
descriptionstringYesSkill description, max 1000 chars
howItWorksstringNoHow it works text
clawhubUrlstringNoClawHub URL
githubUrlstringNoGitHub URL

​
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

curl -X POST "https://pm-t1.bxingupdate.com/bvapi/agent/skill/submit-skill" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skillName": "Weather Arbitrage",
    "version": "1.0.0",
    "description": "Use weather signals to identify divergence.",
    "howItWorks": "Scan weather events and place entries.",
    "clawhubUrl": "https://clawhub.ai/skills/weather-arbitrage",
    "githubUrl": "https://github.com/aionmarket/weather-arbitrage-skill"
  }'

​
Response Example

{
  "id": "12",
  "skillCode": "b0d9a8ad-ae9d-4f4f-a7fc-26058bde79bf",
  "createSource": 1,
  "reviewStatus": 1,
  "createdAt": "1713000000000"
}