Skill 录入模板
返回:精选 Skill 收藏
目录结构
text
docs/ai/prompt-skill/good-skills/
├── index.md # 分类导航
├── template.md # 本页
├── coding/
│ ├── index.md # 编码开发目录
│ └── <skill-id>.md # Skill 详情
├── writing/index.md # 文档写作目录
├── data/index.md # 数据处理目录
├── research/index.md # 研究检索目录
├── office/index.md # 办公协作目录
├── image/
│ ├── index.md # 图像创作目录
│ └── <skill-id>.md # Skill 详情
└── video/
├── index.md # 视频与动效目录
└── <skill-id>.md # Skill 详情分类页条目
在对应分类的 index.md 里追加:
md
### [英文名(中文简称)](/ai/prompt-skill/good-skills/<category>/<skill-id>)
<div style="display:flex;gap:14px;align-items:flex-start;margin:8px 0 24px;">
<img src="/assets/img/skills/<skill-id>/preview.jpg" alt="效果预览" style="width:132px;height:auto;border-radius:6px;border:1px solid var(--vp-c-divider);flex:none;">
<div>
<p style="margin:0 0 8px;">一句话说清它解决什么问题(40 字内)。</p>
<p style="margin:0;color:var(--vp-c-text-2);font-size:13px;">使用场景 · 形态 · 来源工具<br><a href="原始分享地址">原文</a> · <a href="仓库地址">GitHub</a> · <a href="/ai/prompt-skill/good-skills/<category>/<skill-id>">详情</a></p>
</div>
</div>标题统一写成「英文名(中文简称)」:中文简称 3–5 字,点明效果或用途。每条必须配 preview.jpg;同一个 Skill 有多篇分享时,详情页出处全部列出,分类页写成 原文 1 / 原文 2。
详情页
在分类目录下新建 <skill-id>.md:
md
---
title: 英文名(中文简称)
description: 一句话说清它解决什么问题
hidden: true
sidebar: false
outline: [2, 3]
---
# 英文名(中文简称)
> 返回:[分类名](/ai/prompt-skill/good-skills/<category>/)
一句话定位 + 效果图。
## 为什么收它
它解决了什么、和同类比强在哪、不适合什么场景。
## 怎么用
安装位置、调用方式、依赖条件。
## 挑选建议
同类 Skill 怎么选、容易踩什么坑。
## 出处
原文、仓库、作者、发布时间。总览卡片
分类与项目卡片统一用本地 ::: link-card 容器,每张卡以 - title: 开头,字段包括 icon、desc、link,以及可选的 github、created、updated、tags。link 默认站内跳转;需要新窗口时加 external: true。github 始终新开窗口,created / updated 写成 YYYY-MM-DD 静态展示,tags 写成 [标签1, 标签2]。
来源分组
总览页的「📦 按来源浏览」给同一来源累计 2 条以上的仓库单独成组(当前为 anthropics/skills、vercel-labs/agent-skills、alchaincyf、Vincentwei1021),组内按分类列链接,指向现有详情页。单条来源统一收进「独立来源」组,也按分类列。新增 Skill 时:来源已有分组,就在该组对应分类行补链接并更新计数;只有一条的来源加到「独立来源」;当某个独立来源累计到 2 条,再拆成单独分组。
图片
- 缩略图统一为 540×720 竖版 JPG,放在
docs/public/assets/img/skills/<skill-id>/preview.jpg; - 分类页以 132px 宽展示,
height:auto自适应; - 详情页封面统一用
<div style="max-width:300px;margin:16px 0;">包裹,图片width:100%;height:auto;多张示例图同样固定 300px 宽,避免尺寸忽大忽小; - 详情页可另放 1–2 张原图;
- 原仓库没有可用截图时,可制作同尺寸的品牌封面,并在详情页注明「封面为本收藏自制示意图」;
- 注明图片来自原仓库或原文,版权归原作者。
