Agent Skills

Hermes Agent 的技能库，严格遵循 Agent Skills 规范。

每个技能独立文件夹，包含 SKILL.md（frontmatter + 指令）及可选的 scripts/、references/、assets/ 目录。

快速导航

分类	技能数	跳转
Chatbot	1	→
Creative	2	→
DevOps	2	→
Gaming	1	→
GitHub	1	→
MLOps	1	→

---

技能总览

Chatbot

技能	用途	路径
astrbot-plugin-dev	AstrBot QQ 机器人插件开发	chatbot/astrbot-plugin-dev/

astrbot-plugin-dev

AstrBot QQ 机器人插件开发完整指南。基于 20+ 真实插件总结的开发规范，覆盖插件结构、装饰器、消息处理、LLM 集成、配置系统、数据持久化。

→ 完整文档

Creative

技能	用途	路径
architecture-diagram	暗色主题架构图	creative/architecture-diagram/
html-rendering	HTML 页面渲染与截图	creative/html-rendering/

architecture-diagram

生成暗色主题 SVG 架构图（HTML 内联），语义化配色，JetBrains Mono 字体。

→ 完整文档

html-rendering

使用 Playwright 生成样式化 HTML 页面并捕获截图。支持浅色主题、粉彩美学和终端风格设计。

• 禁止纯黑/深灰背景，优先使用暖白、粉彩、奶油色
• 提供三套配色方案：粉彩梦幻、暖白、幽灵终端（按需）
• 完整工作流：生成 HTML → Playwright 截图 → QQ 发送

→ 完整文档

DevOps

技能	用途	路径
ds2api-update	更新 ds2api Docker 容器	devops/ds2api-update/
mihomo-proxy-switch	切换 mihomo 代理节点	devops/mihomo-proxy-switch/

ds2api-update

从 GHCR 拉取最新镜像，重建容器，保留 env-file 和 config volume。

• 镜像：ghcr.io/cjackhwang/ds2api:latest
• 端口：10055→5001，nginx 反代 10100
• ⚠️ 必须带 --env-file，否则 admin 密码丢失

→ 完整文档

mihomo-proxy-switch

通过 mihomo API 切换代理节点、验证出口 IP。

• API 端口：9090，密钥：1234
• mixed-port：7890

→ 完整文档

Gaming

技能	用途	路径
galgame-unpacker	视觉小说资源解包	gaming/galgame-unpacker/

galgame-unpacker

解包 Softpal/Amuse Craft 引擎视觉小说游戏资源。支持 PAC 归档提取和 PGD 图片解码（GE/PGD3 格式，LZSS 压缩）。

• 已测试游戏：CRACK≡TRICK!
• 输出：PNG 格式图片（1280×720）

→ 完整文档

GitHub

技能	用途	路径
github-pr-workflow	PR 全生命周期	github/github-pr-workflow/

github-pr-workflow

从创建分支到合并 PR 的完整流程，支持 gh CLI 或 GitHub REST API fallback。

→ 完整文档

MLOps

技能	用途	路径
huggingface-hub	HF Hub CLI 操作	mlops/huggingface-hub/

huggingface-hub

Hugging Face Hub CLI（hf）：搜索、下载、上传模型/数据集，管理 Spaces。

→ 完整文档

---

目录结构

agent-skills/
├── README.md              ← 本文件
├── LICENSE
├── chatbot/
│   └── astrbot-plugin-dev/
│       └── SKILL.md
├── creative/
│   ├── architecture-diagram/
│   │   └── SKILL.md
│   └── html-rendering/
│       └── SKILL.md
├── devops/
│   ├── ds2api-update/
│   │   └── SKILL.md
│   └── mihomo-proxy-switch/
│       └── SKILL.md
├── gaming/
│   └── galgame-unpacker/
│       ├── SKILL.md
│       └── scripts/
│           ├── unpack_pac.py
│           └── pgd_decoder.py
├── github/
│   └── github-pr-workflow/
│       └── SKILL.md
└── mlops/
    └── huggingface-hub/
        └── SKILL.md

SKILL.md 规范

每个 SKILL.md 必须包含 YAML frontmatter：

---
name: skill-name              # 必填，小写+连字符，≤64字符
description: 描述技能功能       # 必填，≤1024字符
license: MIT                  # 可选
compatibility: 环境要求         # 可选，≤500字符
metadata:                     # 可选
  author: huanxherta
  version: "1.0"
  category: devops
---

详见 Agent Skills 官方规范。

添加新技能

1. 在对应分类目录下创建文件夹（名称与 name 字段一致）
2. 编写 SKILL.md，严格遵循 frontmatter 规范
3. 可选添加 scripts/、references/、assets/ 目录
4. 更新本 README 的技能总览表

License

MIT