Skip to content

About

294 个开源 Agent Skills 精选库:按产出物分类,带真实效果图与逐仓插画,一行命令即插即用。

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

47 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Skill 指北

别再从收藏夹里翻链接了。 给 AI Agent(Claude Code、Cursor、Codex、Gemini CLI)用的开源 Skills 精选库:按「你最后要做出什么」分类,附真实效果预览与一行命令即插即用。

🌐 在线站点:skills.dawsondx.top · 收录 313 个仓库 · 11 个产出物分类 · 14 位创作者 · 纯静态、零前端依赖

Skill 指北首页


这是什么

开源 Agent Skill 越来越多,但找起来很费劲:仓库名看不出能干嘛,README 里全是徽章,装之前也不知道效果长什么样。

这个站点做的就是把它们装裱成一本可以翻的目录:

  • 不按技术栈分类,按最终交付物分类 —— 做 PPT、画图表、剪视频、写公众号、管知识、做设计……
  • 优先给真实效果预览:能拿到仓库自己的演示图就用真图,拿不到的就按这个仓库的定位单独画一张示意图
  • 每条都配一句人话说明、标签、Star 数、最近提交,以及一条可以直接复制的安装命令
  • 数据快照提交进仓库,外部站点挂了也不影响站点本身

画廊视图:真实截图与逐仓绘制的示意图混排


主要功能

功能 说明
场景筛选 11 个分类横向 tab,带每类数量;桌面端自动折行,窄屏可横滑
组合筛选 创作者下拉、有演示图 / 近 30 天更新 / 我的收藏三个开关,可一键重置全部条件
排序 推荐排序(分类轮转,避免同一类霸榜)、Star、最近更新、安装热度
双视图 画廊(装裱式卡片)/ 榜单(表格化网格行,点表头即可排序)
分页 桌面 24 / 页(4 列 × 6 行,正好等于构建期预渲染的 24 张静态首屏),≤900px 12 / 页;页码写进 ?page=,筛选变化自动回第 1 页,榜单排名跨页连续
搜索 搜名称、仓库、说明、标签;/ 直接聚焦
详情抽屉 三段式侧滑面板:效果预览、功能说明书、SKILL.md / README 源码透视、安装命令、宿主兼容、同类替代
快速安装器 切换 npx / Claude Code / Cursor / Codex,命令实时变化,一键复制
安装热度风向标 首屏 Top3 迷你榜,可展开完整榜单;数据取自 skills.sh 公开周安装量快照
收藏夹 存在浏览器 localStorage,不登录、不上传
日夜纸墨主题 D 一键切换,浅色暖纸 / 深色墨色两套同名设计变量
分享深链 ?open=<id> 可直接打开某个 skill 的详情,?view=list 直接进榜单
回首页 点顶栏 logo / 站名,清空全部筛选与深链、关掉抽屉并平滑回到页面顶部

榜单视图:表格化网格行,可点表头排序


详情抽屉

点任意卡片会从右侧滑出详情面板:固定的元数据头、独立滚动的正文、常驻的尾部 CTA。

详情抽屉:效果预览框 + 两个 tab + 安装块

正文分两个 tab:

  • 功能说明书与安装 —— 描述、标签、上游动态(最近提交 / 版本 / Releases)、一键安装命令、宿主兼容矩阵、同作者作品与同类替代
  • SKILL.md 源码透视 / 仓库说明 —— 有真 SKILL.md 就看源码前 24 行;没有则展示从 README 清洗出的纯文本摘要(已去掉图片、徽章与代码块)

抽屉的完整设计拆解、与样板的逐项对照、以及迁移实施记录见 👉 docs/drawer-spec.md。

暗房墨色主题


设计语言

维度 取值
底色 暖纸 #F7F3EA / 纸面 #FFFCF6 / 凹槽 #FBF6EC
主色 珊瑚橙 #D9553A(涨、强调)· 墨青 #0F5F58
文字 三级:#17130E / #57503F / #8A8271,行高 ≥ 1.4
字体 正文系统无衬线,标题宋体,数字与命令等宽
圆角 / 阴影 四级圆角 + 三级阴影
动效 卡片 300ms cubic-bezier(0,0,.2,1);遮罩 200ms 先落定;尊重 prefers-reduced-motion
暗色 :root[data-theme="dark"] 覆盖同一套变量,不需要写第二份组件样式

快速开始

直接看

打开 https://skills.dawsondx.top/,或者本地直接双击 site/index.html(静态页,file:// 也能跑)。

本地起服务

cd site
npm start                 # node server.mjs,默认 http://localhost:3000

server.mjs 是零依赖的 Node HTTP 服务,只做一件事:代理 GitHub 上游动态(浏览器直连 commits.atom 会被 CORS 拦、匿名 API 又限流)。它用 stale-while-revalidate,首屏永远不等抓取。

在 GitHub Pages 上这个接口不存在(/api/upstream 404),页面会自动回落到仓库里提交的快照数据,功能不受影响。

快捷键

键 作用
/ 聚焦搜索框
D 切换日夜纸墨主题
ESC 关闭抽屉 / 弹层

改了卡片模板之后

card-template.js 是构建期和浏览器共用的同一份实现,所以改完必须重跑预渲染,否则首屏静态卡片会和 JS 渲染长得不一样:

node _tools/prerender.mjs

项目结构

.
├── site/                       ← GitHub Pages 直接托管这个目录
│   ├── index.html              ← 页面骨架(含构建期注入的首屏 24 张卡片 + JSON-LD)
│   ├── server.mjs              ← 可选:零依赖上游数据代理(本地 / 自托管用)
│   ├── server/                 ← seed.json / cache.json / upstream.mjs
│   └── assets/
│       ├── css/style.css       ← 全部样式与主题变量
│       ├── js/
│       │   ├── data.js         ← 313 条仓库主数据(唯一真相源)
│       │   ├── demo-images.js  ← 从仓库 README 补抓的演示图清单
│       │   ├── cover-art.js    ← 135 个无图仓库的逐仓插画设计稿
│       │   ├── card-template.js← 卡片 HTML 模板(前端 + 预渲染共用)
│       │   ├── skillmd-index.js / skillmd.js  ← 源码快照索引 / 正文(按需加载)
│       │   ├── pulse.js        ← 每周安装热度
│       │   └── app.js          ← 全部交互
│       └── img/                ← 163 张自托管演示图(已压成 WebP)
├── _tools/                     ← 零依赖抓取与构建脚本(Node 内置模块,无需 npm install)
├── docs/
│   ├── drawer-spec.md          ← 详情抽屉的系统研究与迁移对照说明
│   └── img/                    ← 本文档插图
└── .github/workflows/pages.yml ← 定时刷新 + 构建 + 部署

数据是怎么来的

数据流向图

四类上游数据被抓成 JS 快照提交进仓库,构建期预渲染和浏览器运行期消费的是同一份数据:

数据 来源 脚本
仓库清单 / 分类 / 创作者 / Star 人工筛选 + 上游快照 fetch-upstream.mjs
演示图 各仓库 README 里的图片,下载校验尺寸后自托管 fetch-demo-images.mjs
逐仓插画 人工按每个仓库定位单独设计,DOM 微版式而非生成图片 cover-art.js
SKILL.md / README 摘要 raw.githubusercontent.com,失败自动回落 fetch-skillmd.mjs
每周安装热度 skills.sh 首页公开 RSC 载荷(匿名 npx skills add 遥测) fetch-pulse.mjs

构建期 prerender.mjs 用 node:vm 加载同一份 card-template.js,把推荐排序前 24 张卡片、全量 schema.org/ItemList JSON-LD 和 <noscript> 目录直接写进 index.html —— 首屏不依赖 JS,爬虫也能拿到完整内容。

所有抓取脚本都遵循同一条原则:快照提交进仓库,外部站点抖动不挡部署。CI 里刷新失败会沿用上次数据并继续发布。


常用命令

命令 作用
node _tools/prerender.mjs 重生成首屏卡片 / JSON-LD / noscript(改模板后必跑)
node _tools/prerender.mjs --check 只校验不写盘,CI 可用
node _tools/fetch-upstream.mjs --write 刷新仓库最近提交 / 版本 / Star
node _tools/fetch-demo-images.mjs 补抓演示图(--limit 10 先试跑)
node _tools/fetch-skillmd.mjs 重抓 SKILL.md / README 摘要(约 40 秒)
node _tools/fetch-pulse.mjs 刷新安装热度榜
node _tools/optimize-images.mjs 把大图压成 WebP
npm start(在 site/ 下) 起本地服务

构建与部署

.github/workflows/pages.yml 在 push、每天定时和手动触发时跑:

  1. refresh(仅定时 / 手动)—— 刷新上游快照与源码快照,有变化才提交回 main
  2. build —— prerender.mjs 重生成静态首屏与 SEO 数据,顺手刷一次安装热度,上传 site/ 作为 Pages 产物
  3. deploy —— 发布到自定义域 skills.dawsondx.top

push 事件会跳过 refresh,直接用仓库里已提交的快照,保证每次部署都快且可复现。


版权与致谢

  • 站内所有 Skill 均来自各自的开源仓库,版权归原作者所有;中文说明由本站撰写,仅作导航介绍。
  • site/assets/img/ 里的演示图版权归各仓库作者,此处仅作效果展示。
  • 逐仓插画(cover-art.js)为本站按项目定位手工绘制的示意图,不是仓库原始截图,卡片上会明确标注。

如果某个仓库的说明写错了、想补充一个值得收录的仓库,欢迎提 Issue 或 PR;站点右下角也有「提交 skill」入口。


相关文档

About

294 个开源 Agent Skills 精选库:按产出物分类,带真实效果图与逐仓插画,一行命令即插即用。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages