前言¶
在騰訊 SkillHub 上架自定義 Skill,通常要先寫一份符合規範的 SKILL.md:元數據、觸發說明、步驟約束都要對齊平臺約定。自己對照文檔拼骨架,容易漏字段或結構不一致。下面介紹社區 Skill「SKILL.md模板生成器·騰訊SkillHub專用」:根據你描述的技能需求,生成可直接複製粘貼的完整 SKILL.md,降低新手寫技能說明的門檻。
這是什麼¶
SKILL.md模板生成器·騰訊SkillHub專用(座標 @user_a41ae6c8/skill-md-template-maker,版本 1.0.0)是 SkillHub 社區(community)發佈的開發類 Skill,分類爲 dev-programming,由發佈者 user_a41ae6c8(SkillHub 頁面標註作者爲葳臣)維護。
官方簡介:根據你的技能需求,一鍵生成可直接複製粘貼的標準 SKILL.md 完整文件,新手零門檻創建騰訊技能商店技能。標籤標明 requires_api_key=false,安裝後無需額外 API Key。
SkillHub 頁面數據(截至抓取):評分 100000,下載 2069 次,安裝 60 次。
核心功能¶
依據已公開說明,該 Skill 的能力可以概括爲:
- 接收你對「要做什麼技能、解決什麼問題」的自然語言描述。
- 按通用 SKILL.md 格式輸出完整文件(非零散片段),便於直接放進技能目錄或提交到 SkillHub。
- 面向騰訊技能商店(SkillHub)的創建流程,減少對照規範手冊手工搭結構的時間。
具體字段模板、生成規則以安裝後的 SKILL.md 正文爲準;本文不展開未在官方頁面列出的腳本或配置項。
安裝與啓用¶
SkillHub 官方頁面給出的安裝方式是:讓 AI 參照安裝文檔,安裝座標 @user_a41ae6c8/skill-md-template-maker。安裝文檔地址:
https://skillhub.cn/install/skillhub.md
1、安裝 SkillHub CLI(若尚未安裝)¶
先檢查是否已有 CLI:
command -v skillhub && skillhub --version
未安裝時,可按安裝文檔執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝文檔要求:必須用 --dir 指向當前 Agent 識別的 skills 目錄,否則默認落在 ./skills/ 可能不會被加載。
skillhub install @user_a41ae6c8/skill-md-template-maker --dir <你的 skills 目錄>
常見路徑(來自 SkillHub 安裝文檔,按你實際使用的客戶端選擇):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
安裝完成後,按你所用 Agent 的慣例重啓或刷新技能列表,使新 Skill 生效。
典型用法¶
官方未單獨給出分步教程,結合簡介與 SkillHub 上常見的 Skill 交互方式,可復現的流程如下:
- 在已啓用該 Skill 的對話中,說明你要做的技能:目標用戶、觸發場景、輸入輸出、需要遵守的約束(例如是否調用外部 API、是否禁止讀某些路徑)。
- 請 Agent 使用本 Skill 生成完整
SKILL.md內容。 - 將生成結果保存爲技能包內的
SKILL.md,再按 SkillHub 發佈流程上傳或本地調試。
示例提示(示意,非官方固定文案):
我要做一個在 Cursor 裏用的 Skill:根據用戶給的倉庫路徑做依賴漏洞掃描摘要。
請用 skill-md-template-maker 生成符合 SkillHub 的完整 SKILL.md,包含名稱、描述和分步說明。
生成物是否一次達標,取決於你描述的需求是否完整;必要時在同一對話裏補充邊界條件後讓 Agent 修訂同一文件。
適用場景與注意¶
適合誰
- 第一次在 SkillHub 發佈 Skill、不熟悉
SKILL.md結構的開發者。 - 已有技能想法,希望先得到標準骨架再自行改文案和步驟的團隊。
限制與注意
- 生成內容是起點,上架前仍需你覈對業務準確性、安全約束與平臺最新規範。
- 本 Skill 專注「模板與結構」,不替代你對技能邏輯、腳本和依賴的自行實現與測試。
- 安裝統計與評分來自 SkillHub 頁面,會隨時間變化;以商店頁爲準。
結尾¶
若你的痛點是「知道要做什麼 Skill,但不想從零拼 SKILL.md」,可以先把 @user_a41ae6c8/skill-md-template-maker 裝進當前 Agent,用需求描述換一份可粘貼的完整技能說明,再進入 SkillHub 的調試與發佈環節。
- SkillHub 技能頁:https://www.skillhub.cn/skills/user_a41ae6c8/skill-md-template-maker
- API 入口(商店關聯):https://api.skillhub.cn/user_a41ae6c8/skill-md-template-maker
- 安裝說明:https://skillhub.cn/install/skillhub.md