Skill

Skill Marketplace

Placement

Skills are shown in the WorkBuddy marketplace. Users click Experts · Skills · Connectors in the left menu to open the secondary menu, choose Skills, and enter the Skill Marketplace.

Users click the plus sign in the upper-right corner of a skill to install it, and can invoke installed skills in conversations.

Skill creation tools

Click Add Skill - Create Skill in the upper-right corner of the marketplace.

You are taken into a conversation. Complete the prompt for creating a skill, then start creation.

Why parsing fails on the Open Platform

If zip parsing fails while you are creating a skill on the Open Platform, use Skill basic structure and Sub-resource directories below to locate the issue. If you still cannot resolve it, email operations at openworkbuddy@tencent.com, or scan the QR code at the bottom of the Open Platform home page to join the community.

Skill basic structure

skills/
└── {skill-name}/
    ├── SKILL.md              # ★ 技能定义（必须）
    ├── references/           # 参考资料（可选）
    │   ├── api-spec.md       #   API 规范、字段类型等
    │   └── examples.md       #   示例数据
    ├── scripts/              # 可执行脚本（可选）
    │   ├── fetch-data.js     #   数据获取脚本
    │   └── transform.py      #   数据处理脚本
    └── templates/            # 模板文件（可选）
        ├── report.sh         #   报告生成模板
        └── workflow.sh       #   工作流模板格式

SKILL.md uses YAML frontmatter + Markdown body:

---
name: your-skill-name
display_name: 展示名称
display_name_en:
description: 一句话描述技能能力
description_zh: 简短中文介绍
description_en: A Brief English Introduction
category: writing            # 分类之一
version: 1.0.0
author: 合作方名称
---
 
# 技能指令正文
 
当用户需要做 XX 时，按以下步骤执行：
1. ...
2. ...
3. ...

Frontmatter fields:


Field	Required	Description
name	No	Skill identifier
description	Yes	State the purpose and trigger words
description_zh	Yes	Brief Chinese introduction
description_en	Yes	Brief English introduction
allowed-tools	No	Tool allowlist (comma-separated)
version	Yes	Version number
disable-model-invocation	No	If true, the AI will not auto-trigger; the user must invoke it manually
user-invocable	No	If false, the menu is hidden; for AI internal use only
author	Yes	Partner name

Sub-resource directories

references — References

Stores supplementary knowledge documents referenced by SKILL.md. The AI reads these files as context when executing the skill.

Typical uses: API field type definitions, protocol specs, domain knowledge, example data, and similar.

How to use: reference them in SKILL.md via @references/xxx.md.

Example:

references/
├── field-types.md           # 字段类型枚举和用法
├── api-endpoints.md         # API 接口文档
└── best-practices.md        # 最佳实践指南

scripts — Executable scripts

Stores scripts that the skill needs to invoke. The AI runs them via the Bash tool.

Typical uses: calling external APIs, data processing, batch operations, and logic that requires a specific runtime.

How to use: declare the invocation command and parameters in SKILL.md.

Example:

scripts/
├── data-index.js            # 数据查询入口
└── tool-index.js            # 工具集入口

templates — Template files

Stores reusable template scripts or configuration files.

Typical uses: templates for standardized operation flows, and report generation templates.

Example:

templates/
├── authenticated-session.sh  # 认证会话模板
└── capture-workflow.sh       # 数据采集工作流模板