jiawood2006/hermes-skills

🧰 Hermes Skills · 中文实用技能包 / Practical Chinese Agent Skills

你的 Agent 很聪明，但它搞不定中文世界的活儿。 抖音文案要手抄？扫描合同要肉眼敲？AI 写的稿子一股机器味？电商主图一张张 P？ 这里就是给 Agent 装的 中文生存技能包——8 个开箱即用的实用技能，免费开源，复制即用。

Your agent is smart — but useless on Chinese real-world tasks. Douyin video→text, Chinese OCR, de-AI writing, e-commerce images. This is its Chinese survival kit.

🎯 定位 / Positioning：GitHub 技能市场 99% 是英文开发工具——这里是稀缺的中文场景实用技能。Practical Chinese-language agent skills — the rare gems in a market full of English dev tools.

⭐ 觉得有用？点个 Star 支持一下 → ⭐ Star this repo — 你的支持是开源的动力！ ⭐ If you find this useful, please Star it — it keeps the project alive!

🖼️ 效果示例 / Demo（30 秒看懂能干什么）

🛒 电商素材工坊：白底图 → 使用场景图

输入：产品白底图 / Input	输出：场景合成图 / Output

一键把白底产品图放进真实使用场景（演示图为 AI 生成的无品牌通用产品） One-click scene composition from a plain product photo (demo shows an AI-generated unbranded product)

✍️ de-ai-writer：去 AI 味前后对比

去掉"首先/其次/总而言之"，恢复真人说话的样子 Removes "firstly / moreover / in conclusion" — sounds like a human again

🎬 video-to-text：抖音链接 → 自动转写（一条命令）

$ vtt "https://v.douyin.com/xxxx/"
🎬 视频元数据        title: 3个超实用的生活小技巧
📼 已下载视频        author: 生活达人小李
✅ 转写已保存: 3个超实用的生活小技巧_transcript.md（12 段 / 380 字）
[00:00] 大家好，今天分享三个超实用的生活小技巧
[00:07] 第一个，用牙膏清洁银饰…

不用手动存视频：链接 → 自动下载 → 本地转写 → 结构化 Markdown，一条命令跑完 One command: Douyin link → auto-download → local transcription (privacy-safe, no API key)

🎬 30 秒体验（零安装 · 无需 Key）/ Try it in 30s

去 AI 味 —— 不用装任何东西，直接跑（内置示例，纯本地规则引擎）：

curl -sL https://raw.githubusercontent.com/jiawood2006/hermes-skills/main/skills/de-ai-writer/scripts/demo.py | python3 -
# 处理你自己的文本:
curl -sL https://raw.githubusercontent.com/jiawood2006/hermes-skills/main/skills/de-ai-writer/scripts/demo.py -o demo.py \
  && python3 demo.py -t "首先，这款产品不仅性能卓越，更是彰显了我们的创新精神。"

输出 before/after 对照 + "共清除 N 处 AI 味表达"——效果立现。

⚡ 60 秒快速上手 / Quick Start

# 1. 安装（任选一种）
# 方式一：hermes 命令（推荐，自动装到 ~/.hermes/skills/utilities/）
hermes skills install jiawood2006/hermes-skills/skills/video-to-text
# 方式二：复制目录（任意 Agent 都可用）
mkdir -p ~/.hermes/skills/utilities && cp -r skills/* ~/.hermes/skills/utilities/

# 2. 开箱即用（示例）
# 视频转文字：python3 ~/.hermes/skills/utilities/video-to-text/scripts/vtt.py "抖音链接或视频文件"
# 文档OCR：   python3 ~/.hermes/skills/utilities/doc-ocr/scripts/dococr.py 合同.pdf
# 去AI味：    python3 ~/.hermes/skills/utilities/de-ai-writer/scripts/deai.py 稿子.txt -o 改好.txt

# 3. 在 Agent 里直接用
# 对 Hermes/Claude Code 等 Agent 说："帮我转这个视频文字 / 这段文字去AI味 / 扫描件提取文字"

💡 路径说明：仓库内路径是 skills/xxx/，安装后路径是 ~/.hermes/skills/utilities/xxx/（hermes 命令默认按分类安装）。两个都支持，别混淆。

🎯 解决什么问题 / What problems does this solve?

📦 技能清单 / Skill List

1️⃣ video-to-text · 抖音视频一键转文字

• 中文：抖音分享链接 → 自动下载 → 本地转写（一条命令闭环）+ 结构化 Markdown + SRT/VTT 字幕（带真实时间戳）+ 内容摘要/爆款结构拆解
• English: Douyin link → auto-download → transcribe in ONE command + structured Markdown + SRT/VTT subtitles + viral analysis
• 中文优化：默认输出简体中文 + 标点，字幕按句切分（不会一条横跨十几秒）
• 适用：短视频文案采集、内容情报、爆款拆解、给视频配字幕
• 依赖：macOS/Linux；转写需 pip3 install faster-whisper（可选 SenseVoice 更准）；分析需 LLM key

2️⃣ de-ai-writer · 中文去 AI 味写作引擎

• 中文：AI味体检（免key）+ 去 AI 味 + 35 条中文 AI 腔模式清单 + 风格克隆 + 变体生成 + 语气调节 + 8 维度评分
• English: AI-smell check (no key) + de-AI + 35-pattern Chinese AI-smell catalog + style cloning + variants + tone control + quality scoring
• 适用：公众号、小红书、电商文案、小说文风模仿
• 依赖：check / demo 模式零依赖免 key；深度改写需 LLM key（--prompt-only 零成本模式也可用）
• 与英文 humanizer 的区别：中文 AI 味 ≠ 英文 AI 味——英文看 delve / em-dash，中文看"赋能/闭环/公文套话/翻译腔"。我们有 10 条中文特有腔调，另有本地规则引擎，可进脚本流水线

3️⃣ doc-ocr · 文档识别 + 结构化

• 中文：PDF/扫描件/图片 OCR + 可搜索 PDF（扫描件写隐形文字层，可 Ctrl+F/复制）+ 页眉页脚水印过滤 + 发票/合同字段抽取 + 表格转 CSV
• English: OCR for PDFs/scans/images + searchable-PDF output + header/footer/watermark filtering + structured extraction (invoices/contracts/tables)
• 适用：合同扫描、发票归档、票据数字化、扫描件做成可检索档案
• 依赖：macOS（Vision 引擎）；结构化需 LLM key

4️⃣ ecommerce-material-studio · 电商素材工坊

• 中文：电商主图/详情图/场景图批量生成 + AI 场景融合（图生图真实融入）
• English: Batch e-commerce images + AI scene fusion (Qwen-Image-Edit)
• 适用：淘宝/拼多多/快手商家素材生产
• 依赖：pip install Pillow numpy scipy；AI 融合需硅基流动 key

5️⃣ memory-manager · 记忆健康管理

• 中文：Agent 记忆健康检查——统计 token 占用、找过期/冗余条目、会话库表级体检（区分"正文大"还是"索引大"）、从会话历史挖掘用户纠正（提示哪些长期偏好还没进记忆）
• English: Agent memory health check — token cost, stale entries, table-level session-DB diagnosis, and correction mining from chat history
• 适用：任何 Agent 的记忆维护，防止上下文被挤占
• 依赖：零依赖（纯 Python 标准库）

6️⃣ memory-graph · 长文记忆图谱

• 中文：四维图谱（实体网+时间线+因果链+概念库）——小说/连载写作自动提取记忆，多跳关系展开+伏笔追踪+一致性检查+旧设定弃用/恢复（改稿不删设定）
• English: Four-graph memory (entity/timeline/causality/concept) for long-form writing — multi-hop queries, plot-thread tracking, consistency checks, and retire/revive for revised canon
• 适用：小说、连载、剧本、系列教程、世界观设定管理
• 依赖：提取需 LLM key（--no-llm 规则模式可用）

7️⃣ ai-project-advisor · AI 工程顾问

• 中文：微信/企微对话式工程项目顾问——记录项目事实、盯关键节点、提醒风险
• English: WeChat/WeCom conversational engineering project advisor — records facts, tracks milestones, alerts risks
• 适用：工程公司老板/项目经理的项目管理助手
• 依赖：需在服务器部署（腾讯云/任意 Linux），配企业微信机器人

8️⃣ voice-persona · 语音人格（IM 语音双工）

• 中文：IM 里的语音闭环——微信语音（silk）解码转写 + 6 种人格化回复 + EdgeTTS 零成本合成，让 Agent 能听会说、还有性格
• English: Voice I/O loop for IM agents — decode WeChat silk voice, transcribe, reply in 6 personas, synthesize with EdgeTTS (zero cost)
• 适用：微信/企微机器人语音交互、客服人格化、语音助手
• 依赖：pilk（silk 解码）+ faster-whisper（转写）；TTS 用 EdgeTTS 免 key

🚀 安装 / Installation

支持任何 Agent / host——SKILL.md 遵循 agentskills.io 开放标准（Claude Code / Codex / Cursor / Gemini CLI / OpenCode / Hermes / npx skills…）：

# 方式一：Claude Code 插件市场（一条命令，自动更新）
/plugin marketplace add jiawood2006/hermes-skills
/plugin install hermes-skills@hermes-skills

# 方式二：skills CLI（支持 50+ Agent 生态: Claude Code/Codex/Cursor…）
npx skills add jiawood2006/hermes-skills --global     # 装全部
npx skills add jiawood2006/hermes-skills/skills/video-to-text -g   # 装单个

# 方式三：一键安装脚本（装全部 + 全局命令 deai-demo/vtt/dococr/v2t 等）
git clone https://github.com/jiawood2006/hermes-skills.git
cd hermes-skills && ./install.sh

# 方式四：任意 Agent（手动复制到技能目录）
mkdir -p ~/.claude/skills && cp -r skills/* ~/.claude/skills/

# 方式五：Hermes 官方命令（自动按分类安装）
hermes skills install jiawood2006/hermes-skills/skills/de-ai-writer
hermes skills install jiawood2006/hermes-skills/skills/video-to-text
hermes skills install jiawood2006/hermes-skills/skills/doc-ocr
hermes skills install jiawood2006/hermes-skills/skills/ecommerce-material-studio
hermes skills install jiawood2006/hermes-skills/skills/memory-manager
hermes skills install jiawood2006/hermes-skills/skills/memory-graph
hermes skills install jiawood2006/hermes-skills/skills/ai-project-advisor
hermes skills install jiawood2006/hermes-skills/skills/voice-persona

# 方式六：复制目录（纯手动，路径与各技能 SKILL.md 保持一致）
mkdir -p ~/.hermes/skills/utilities
cp -r skills/* ~/.hermes/skills/utilities/

💡 兼容 agentskills.io 开放标准——其他支持 Skills 的 Agent 也能用。 📁 安装后脚本路径：~/.hermes/skills/utilities/<技能名>/scripts/（各技能 SKILL.md 内命令均基于此路径）。 ✅ 技能校验：python3 scripts/validate_skills.py 一键检查全部 SKILL.md 的 frontmatter 合规性（名称/描述/引用文件），推 PR 前建议先跑一遍。

🔄 持续对标 / Continuous Benchmarking

上架不是终点。 每个技能都会定期与同领域高星同类做对标分析，把可借鉴的做法落地强化——不闭门造车，保持先进性。对标档案（数据快照 + 逐项对比 + 采纳项 + 下次待办）全部公开在 docs/benchmarks/：

结论一句话：★ 差距主要来自分发渠道与受众基数，不代表技能质量；但对方内容深度确实强于我们——所以本轮把内容补厚、把分发包齐。

📝 更新日志 / Changelog

• 2026-09-10 — 第三轮对标（cognee / graphrag / HippoRAG / claude-reflect）：memory-graph v1.1.0 新增旧设定弃用恢复 + 多跳关系展开；memory-manager v1.1.0 新增从会话历史挖掘纠正 + 会话库表级体检（实测 1.2GB 中 71% 是 FTS 索引）；对标档案 docs/benchmarks/2026-09-10-memory-graph-and-memory-manager.md
• 2026-09-10 — 第二轮对标（PaddleOCR / Umi-OCR / OCRmyPDF / douyin-downloader）：doc-ocr v2.1.0 新增页眉页脚水印过滤 + 可搜索 PDF + 多语言；video-to-text v3.1.0 新增 SRT/VTT 字幕导出 + 词级时间戳按句切分 + 中文默认简体带标点；对标档案 docs/benchmarks/2026-09-10-video-to-text-and-doc-ocr.md
• 2026-09-10 — de-ai-writer v2.2.0：新增 35 条中文 AI 腔模式清单（references/ai-patterns-zh.md）+ 30 秒快检表 + 推荐工作流；仓库新增 Claude Code 插件市场安装方式（.claude-plugin/）；新增技能校验脚本 scripts/validate_skills.py；建立持续对标机制与 docs/benchmarks/
• 2026-09-08 — voice-persona 收录进 buildwithclaude 技能列表（PR #311 已合并）
• 2026-09-06 — README 增加 featured-in 徽章（提升搜索可发现性）
• 2026-09-04 — 新增 voice-persona（第 8 个技能，微信语音双工 + 6 人格）；竞品调研驱动改造：README 故事化、跨平台安装、免 key 演示（de-ai-writer check/demo）
• 2026-08-09 — 仓库创建，首批技能 video-to-text / de-ai-writer / doc-ocr

💬 欢迎反馈 / Feedback

用了有意见、有问题、有想法？欢迎提出来，每条都会认真看！ Used it and have feedback, questions, or ideas? Please share — every issue is read!

• 🐛 发现 Bug / Found a bug → 提 Issue / Open an Issue
• 💡 想要新技能 / Want a new skill → 求新技能 / Request a skill
• 💬 随便聊聊 / Just chat → Discussions

你的意见能让这些技能更好用——尤其是"哪里不好用"的吐槽最宝贵。 Your feedback makes these skills better — especially "what doesn't work well".

⭐ 支持作者 / Support

好用请点 Star ⭐——你的支持是开源的动力！ If you find this useful, please Star ⭐ — it keeps the project alive!

• 免费使用，无需任何费用 / Free to use
• 欢迎 PR / Issues / 建议 / PRs, Issues & feedback welcome
• 想支持更多：扫码或联系（详见各技能内 SKILL.md）/ Scan QR or contact (see SKILL.md inside each skill)

📄 License

MIT — 自由使用，保留版权声明即可 / Free to use with attribution.