Skills

这是悟鸣公开维护的一组 Agent Skills，偏实战、偏工作流，主要服务于 AI 工具使用、文档解读、项目配置、运维排障与技能分发。

和“技能清单”相比，这个仓库更适合被理解成一张能力地图：每个 skill 不只是一个说明文件，而是围绕某一类任务组织起来的可复用能力单元。

Skill 地图

1. 文档 / 知识库类（Tool Wrapper）

这类 skill 的核心价值，是把某个产品、系统或知识域的资料包装成可按需触发的上下文。

Skill	模式	适用场景
qoder-wiki	Tool Wrapper	用户询问 Qoder 的安装、使用、功能、定价、MCP、快捷键、Quest Mode、Repo Wiki 等

2. 配置审查 / 结构优化类（Reviewer / Inversion）

这类 skill 的重点不是“直接干活”，而是先判断、先诊断、再给方案。

Skill	模式	适用场景
prompt-optimizer	Reviewer / Generator	优化 Prompt、改进 AI 指令、为特定任务挑选提示词框架
agent-md-advisor	Advisor / Reviewer / Generator	回答 AGENTS.md / CLAUDE.md 最佳实践，诊断并优化 AI agent 指令文件
claude-config-advisor	Reviewer / Inversion	审查或设计 `.claude`、`CLAUDE.md`、Claude Code 项目配置
skill-optimizer	Reviewer / Inversion	审查并优化已有 skill 的触发语义、工作流、确认门槛和资源组织
agent-optimizer	Reviewer / Consultant	基于 12-Factor AgentOps 框架，提供 Agent 设计咨询、审查现有 Agent/Skill/工作流设计，发现问题并给出改进建议

3. 图示 / 可视化类（Generator）

这类 skill 的核心是：把抽象结构、流程和关系，稳定转成可直接渲染的图。

Skill	模式	适用场景
mermaid	Generator / Reviewer	用户要求绘制 Mermaid 流程图、架构图、时序图、状态图、甘特图、ER 图、类图、旅程图等

4. 解读 / 报告生成类（Pipeline / Generator）

这类 skill 的核心是：把原始资料落到本地，再生成结构化文档交付。

Skill	模式	适用场景
github-code-interpreter	Pipeline / Generator	用户提供 GitHub 仓库链接，希望解读源码、分析架构、生成学习报告或快速上手文档
paper-interpreter	Pipeline / Generator	用户提供 arXiv 链接，希望下载论文、解读论文、生成读书笔记或详细报告
opendataloader-pdf	Tool Wrapper / Pipeline	PDF 提取、PDF 转 Markdown/JSON/HTML、RAG 数据准备、批量 PDF 处理

这类 skill 的共同特点：

默认以本地文件为主交付
默认先交付初稿
不自动复查，是否复查需要用户明确同意

5. 运维 / 排障类（Runbook / Tool Wrapper）

这类 skill 适合处理“系统坏了、服务挂了、渠道断了、命令不会用”的场景。

Skill	模式	适用场景
openclaw-ops	Tool Wrapper / Runbook	OpenClaw 状态检查、日志排查、Gateway/渠道/Agent 故障处理
openclaw-session-cleaner	Tool Wrapper / Runbook	清理 OpenClaw 膨胀的 session 文件、删除旧 cron session、重建 `sessions.json` 引用
copaw-ops	Tool Wrapper / Runbook	CoPaw 服务状态检查、配置排障、模型问题、cron 异常、渠道故障
hermes-ops	Tool Wrapper / Runbook	Hermes Agent 运维、故障排查、gateway 异常、平台掉线、cron 不执行、profile 配置问题
hermes-qq	Pipeline	为 Hermes Agent 正式版 main 分支补充 QQ 平台支持、QQ Bot 接入、QQ 文件发送

这类 skill 的共同原则：

先做状态检查，再决定是否修复
高影响动作（重启、repair、更新、配置修改）应先说明再执行

6. 安装类（Pipeline）

这类 skill 偏工具链管理，负责把能力装上去。

Skill	模式	适用场景
claudian-installer	Pipeline	安装 Claudian Obsidian 插件，把 Claude Code 接进 Obsidian

使用建议

什么时候优先选哪类 skill？

问产品文档 / 官方资料 → 先看 wiki 类 skill
想优化 Prompt / 配置 / skill 本身 → 先看审查优化类 skill
想把流程、结构、时序整理成图 → 用 mermaid skill
想把论文 / 仓库整理成报告 → 用解读生成类 skill
服务出问题、命令不会用、要排障 → 用运维类 skill
要把能力装到工具里、同步到多个目录 → 用安装同步类 skill

仓库设计原则

这批公有 skill 默认遵循这些原则：

description 是给模型看的触发规则，不只是简介
SKILL.md 负责调度，细节尽量拆到 references / scripts / assets
默认先交付初稿，不自动做超出用户预期的后续动作
需要高影响操作时，先说明再执行
能脚本化的重复动作，尽量不要只写成文字说明
持续沉淀 Gotchas，降低误触发和翻车概率

新增 skill 时建议遵循的规范

如果后面继续往这个仓库加新 skill，建议统一按这套来：

frontmatter 只保留 name 和 description
description 要同时写清：
- 做什么
- 什么时候触发
- 必要时写一句不适用场景
SKILL.md 优先写：
- 适用边界
- 设计模式（如 Tool Wrapper / Generator / Reviewer / Inversion / Pipeline）
- Gotchas
- 工作流
- 输出要求
如果 skill 逻辑较长，优先拆到：
- references/：规范、模板、清单、补充文档
- scripts/：可执行脚本
- assets/：固定模板、示例资源
如果 skill 涉及高影响动作、自动复查、定时任务、外部写操作，要明确写出确认门槛
如果 skill 只是审查或规划类，默认遵循：先审查 / 诊断，再出计划，确认后再修改

安装

Method 1: Install directly in Claude Code

Add plugin marketplace

/plugin marketplace add chujianyun/skills

Install skills

安装所有，发送: "安装 https://github.com/chujianyun/skills" 所有 skills

安装某个，发送: "安装 https://github.com/chujianyun/skills" 中的 xx skill

Method 2: Using openskills

openskills install chujianyun/skills --global

Contact

License

All Skill files in this project are licensed under CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike).

For commercial use, please contact the author for authorization.

Name	sync-skills
Description	Use when syncing skills from local folders, GitHub URLs, or skillsmp.com pages to multiple AI coding tool directories

sync-skills

SKILL.md