From add32f044e4b8d3534e42179bc118a92fe5c9fe0 Mon Sep 17 00:00:00 2001 From: wowo-zZ Date: Fri, 31 Jul 2026 10:30:51 +0800 Subject: [PATCH] docs(builtin-skills): invite community skill sharing Signed-off-by: wowo-zZ --- README.md | 14 ++++++++++++++ README_zh.md | 11 +++++++++++ builtin-skills/README.md | 27 +++++++++++++++++++++++---- 3 files changed, 48 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 23b959c0..8695777c 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,20 @@ firewall, with the same polish you'd expect from a public registry. > ⭐ If SkillHub fits your team, **star** the repo to help other teams find it, and **Watch → Custom → Releases** to get notified when a new version ships. +## Share Great Skills + +Great Skills become more valuable when they are shared. If you have a Skill that has +proved useful in real work or everyday life, share it with the SkillHub community and +help grow an open, practical Skill ecosystem. We welcome Skills for daily life, office +work, learning and research, travel and events, content creation, data analysis, and +software development—not only engineering workflows. + +High-quality community contributions may join the curated starter collection, making new +SkillHub deployments useful from day one. You do not need to finish the full adaptation +before joining in: [open an issue](https://github.com/iflytek/skillhub/issues/new/choose) +with the Skill's source and the problem it solves, or submit a PR by following the +[Skill sharing guide](./builtin-skills/README.md). + ## Documentation - 📖 **[User Guide](https://iflytek.github.io/skillhub/)** — Skill publishing, search, CLI usage and other user guides diff --git a/README_zh.md b/README_zh.md index 20217483..360c0f46 100644 --- a/README_zh.md +++ b/README_zh.md @@ -35,6 +35,17 @@ SkillHub 是一个自托管平台，为团队提供私有的、受治理的智 > ⭐ 如果 SkillHub 适合你的团队，欢迎 **Star** 本仓库帮助更多团队发现它；点 **Watch → Custom → Releases** 可在新版本发布时收到通知。 +## 分享优秀 Skill + +优秀的 Skill 在分享中产生更大价值。如果你有一个在真实工作或生活场景中反复打磨、确实好用的 +Skill，欢迎分享给 SkillHub 社区，与大家一起丰富开放、实用的 Skill 生态。无论是日常生活、 +办公协作、学习研究、旅行活动、内容创作、数据分析还是软件开发，都可以成为有价值的分享。 + +经过验证的社区贡献还有机会进入精选 Skill 集合，让每个新部署的 SkillHub 开箱即用。不必完成 +全部适配后才能参与：你可以先[创建 issue](https://github.com/iflytek/skillhub/issues/new/choose)， +说明 Skill 的来源和它解决的问题；也可以按照[Skill 分享指南](./builtin-skills/README.md) +直接提交 PR。 + ## 文档 - 📖 **[用户指南](https://iflytek.github.io/skillhub/)** — 技能发布、搜索、CLI 使用等用户操作指南 diff --git a/builtin-skills/README.md b/builtin-skills/README.md index 8f5ffda9..1ebd7a69 100644 --- a/builtin-skills/README.md +++ b/builtin-skills/README.md @@ -22,7 +22,26 @@ The build writes deterministic, uncompressed ZIPs and `artifacts.json` to `builtin-skills/dist/`. The artifact index records each ZIP's SHA-256 for the release step; runtime manifest integration is maintained separately from the reviewed source collection. -Do not copy a new upstream Skill directly into this directory. First pin an upstream commit, -confirm redistribution terms, inspect every bundled file, add a realistic case to `evals.json`, -and complete the same package and security review recorded in -`docs/23-builtin-skills-first-round-test-report.md`. +## Share a Skill with the Community + +A Skill shared with the community may be considered for the curated starter collection. +To protect contributors and users, it should: + +- solve a clear, recurring task and add useful coverage to the starter collection; +- identify its author, source, and terms that permit redistribution; +- declare required tools, network access, credentials, and supported environments; +- avoid hidden downloads, embedded secrets, and unconfirmed destructive or external actions; +- pass package validation, security review, and at least one realistic usage test. + +You can start by +[opening an issue](https://github.com/iflytek/skillhub/issues/new/choose) with the source +URL and the problem the Skill solves. A complete pull request should: + +1. add the reviewed package under `builtin-skills/skills//`, including `SKILL.md`, + `LICENSE.txt`, and `NOTICE.md`; +2. record the pinned upstream commit and provenance in `catalog.json`; +3. add a realistic regression case to `evals.json`; +4. run `make test-builtin-skills`. + +Do not copy an upstream Skill into this directory without reviewing every bundled file and +confirming that its license permits redistribution.