awesome-skills

一组可复用的 AI 编程 Skill，按目录独立组织，便于逐个安装、使用和扩展。

当前 Skill

Skill	说明
dsh-plugin-helper	将自然语言需求转化为可安装的 DeepSeek Harness（dsh）插件，并提供插件模板与扩展点参考。
one-click-deploy	将静态网站或已构建的前端项目发布到 Surge 或 Cloudflare Pages。
pwa-save-article	通过 PlayWithAI（pwa）资源站的 create-article 发文 API 保存文章，支持存为草稿或直接发布。

后续新增 Skill 时，直接在根目录创建新的子目录即可。

使用

每个 Skill 都是一个自包含目录，入口说明位于该目录的 SKILL.md。将所需目录复制或链接到所使用的 Agent/Skill 加载目录，然后按对应 README 和 SKILL.md 操作。

例如，使用一键部署 Skill：

bash one-click-deploy/scripts/one-click-deploy.sh ./dist --provider surge

例如，使用发文保存 Skill（需先将其安装到目标项目的 .agents/skills/pwa-save-article/，并配置 PWAI_API_KEY；可先 --dry-run 只做本地校验）：

node .agents/skills/pwa-save-article/scripts/save_article.mjs --file payload.json --dry-run
node .agents/skills/pwa-save-article/scripts/save_article.mjs --file payload.json

具体依赖、参数和安全边界请参阅：

• dsh-plugin-helper/SKILL.md
• one-click-deploy/README.md
• one-click-deploy/SKILL.md
• pwa-save-article/SKILL.md

目录约定

一个 Skill 通常包含：

skill-name/
├── SKILL.md       # 触发条件、工作流和完整规范
├── README.md      # 面向使用者的快速说明
├── metadata.json  # 可选：名称、版本、入口等元数据
├── references/    # 可选：参考资料
├── templates/     # 可选：脚手架
└── scripts/       # 可选：可执行脚本

新增 Skill 时建议：

1. 使用小写 kebab-case 目录名；
2. 提供清晰的 SKILL.md，说明适用场景、依赖、限制和验证方式；
3. 为需要手动使用的 Skill 提供简洁 README；
4. 不提交依赖目录、构建产物、本地配置或凭据；
5. 保持 Skill 可移植，不依赖某台机器上的绝对路径。

开发检查

本仓库目前没有统一的构建系统。提交前至少检查：

git status --short
git diff --check

脚本或模板如有专属检查，请以对应 Skill 的文档为准。

许可证

本项目采用 MIT License。