本地化的职业技能学习与挑选平台 · Personal SkillHub
一个以 Markdown 为唯一真值的本地技能资料库——把外部权威 skill 资源（mcpmarket、skills-sh、anthropics/skills、qoder-community、VoltAgent/awesome-agent-skills 等）按职业技能领域整理成可学习、可挑选、可沉淀的目录。
核心理念
- 职业技能优先：这里的 skills 是岗位胜任能力（job competencies），不是 Agent runtime 能力
- MD 主、Web 次：Markdown 文档是源真值；
tools/web/只是渲染层 - 本地沉淀：支持个人挑选状态（picked / in-progress / learned），独立于版本控制
# 1. 浏览目录(两种方式任选)
open catalog/_index.md # 直接读 MD
open tools/web/index.html # 静态浏览站(含搜索/筛选)
# 2. 跑一次归类/索引/浏览站构建
npm run import:classify # sources → catalog
npm run import:regenerate # 重生成所有 _index.md
npm run web:build # 重建 tools/web/index.html
# 3. 个人挑选
$EDITOR personal/picked.md # 在 personal/ 标记想学的 skill不需要 npm install:所有 tools/ 脚本都是纯 Node,无第三方依赖。
npm install只为 ESLint。
skills-database/
├── catalog/ # 【主】按领域分类的 skills MD
│ ├── _index.md # 总索引
│ ├── frontend/ # 前端开发（12 条）
│ ├── backend/ # 后端工程
│ ├── mobile/ # 移动开发
│ ├── ai-ml/ # AI / ML / LLM
│ ├── data/ # 数据工程
│ ├── devops/ # DevOps / 基础设施
│ ├── security/ # 安全
│ ├── testing/ # 测试工程
│ ├── design/ # 设计与创意
│ ├── product/ # 产品
│ ├── marketing/ # 营销
│ ├── docs/ # 文档
│ ├── productivity/ # 生产力 / 工具
│ ├── tools/ # 第三方工具集成（vendor）
│ └── uncategorized/ # 待整理
│
├── sources/ # 原始采集（来源溯源档案）
│ ├── anthropic/ # 17 条官方
│ ├── mcpmarket/ # 50 条垂直生态
│ ├── skills-sh/ # 50 条英文市场
│ ├── qoder/ # 50 条中文社区
│ ├── voltagent/ # 50 条聚合器
│ └── _global_index.md # 跨站点采集总览
│
├── personal/ # 【本地】个人挑选状态(默认 .gitignore)
│
├── tools/ # 工具集(非核心)
│ ├── import/ # 归类、JSON→MD、索引刷新
│ │ ├── classify.js # sources → catalog
│ │ ├── json-to-md.js # 老 JSON → MD
│ │ └── regenerate-indices.js # 重建 _index.md
│ └── web/ # 【呈现层】静态浏览站
│ ├── build.js # 从 catalog/ 生成 index.html
│ └── index.html # 单文件离线浏览站(可双击打开)
│
├── templates/ # skill frontmatter schema 与模板
├── documentation/ # 项目自身的过程文档
└── README.md / CLAUDE.md / ...
| 领域 | 数量 | 入口 |
|---|---|---|
| 工具集成（vendor） | 63 | catalog/tools/ |
| 测试工程 | 25 | catalog/testing/ |
| 安全 | 21 | catalog/security/ |
| AI / ML / LLM | 19 | catalog/ai-ml/ |
| 数据工程 | 17 | catalog/data/ |
| 设计与创意 | 15 | catalog/design/ |
| 文档 | 13 | catalog/docs/ |
| 前端开发 | 12 | catalog/frontend/ |
| 移动开发 | 8 | catalog/mobile/ |
| 未分类 | 8 | catalog/uncategorized/ |
| 后端工程 | 6 | catalog/backend/ |
| 生产力 / 工具 | 5 | catalog/productivity/ |
| 产品 | 2 | catalog/product/ |
| DevOps / 基础设施 | 2 | catalog/devops/ |
| 营销 | 1 | catalog/marketing/ |
| 总计 | 217 | catalog/_index.md |
归类口径见
tools/import/classify.js。约 3.7% 未自动归类,需手工裁决。
# 直接在 GitHub/VSCode/编辑器里读 MD
open catalog/frontend/_index.md
# 或用 grep 搜全文
grep -r "react" catalog/frontend/- 选一个外部 skill → 写入
sources/<vendor>/<id>.md,带 frontmatter - 跑归类脚本:
node tools/import/classify.js # 实际归类 node tools/import/classify.js --dry # 预览统计
- 脚本会自动:
- 解析 frontmatter
- 按规则映射到
catalog/<领域>/ - 重名时加后缀
- 补充
id / domain / catalogSource / catalogAddedAt字段 - 重新生成每个领域的
_index.md和顶层_index.md
personal/ 目录默认 .gitignore,放你想学的 skill:
<!-- personal/picked.md -->
# 已挑选(待开始)
- [ ] [前端设计](./catalog/frontend/frontend-design.md) — 前端审美补课
- [ ] [代码审查](./catalog/testing/...) — 测试基础| 原则 | 含义 |
|---|---|
| MD 唯一真值 | 所有 skill 都是 .md,可被任意编辑器、grep、静态站消费 |
| 来源可溯 | 每条 catalog MD 的 frontmatter 含 catalogSource,可反查 sources/<source>/<file> |
| 分类可重跑 | tools/import/classify.js 幂等,规则可改后整体重归类 |
| 个人与公共分离 | 个人状态在 personal/,不入库 |
| Web 仅呈现 | tools/web/ 从 catalog/ 渲染,不持有自己的数据库 |
- 补一条 skill:放进
sources/<vendor>/,跑classify.js,提交 PR - 调整分类:改
tools/import/classify.js的 RULES 顺序或新增规则 - 新增领域:在
catalog/下建子目录,把对应 skill 移过去,改 classify 规则
MIT