skill
claude-skills
四套可复用的 Claude Code skill:单文件离线数据看板、Excel 台账提取与口径校验、HTML 幻灯汇报(导出 PDF/PPTX)、总结文档自动脱敏流水线。Four reusable Claude Code skills: offline single-file dashboards, Excel-to-JSON pipelines, HTML slides, redacted r
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/1231Johnny/claude-skills itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 26, 2026技能总结 · Claude Skills
把几个真实项目里可复用的做法抽成了四套 Claude Code skill——每套都是一个自包含的文件夹:一句 SKILL.md 说清什么时候用、怎么用,配套的 scripts/ 是能直接跑的代码,references/ 是详细的规范与踩坑记录。
MIT 许可,随意取用。
English
Four reusable Claude Code skills extracted from real-world data projects. Each skill is a self-contained folder (SKILL.md + runnable scripts/ + references/) covering a different stage of the same pipeline: extracting messy Excel ledgers into defensible JSON → rendering single-file offline dashboards → building HTML slide decks that export to PDF and PPTX → generating shareable Word reports with automated redaction.
Everything is documented in Chinese, but the code and config blocks are self-explanatory. Copy any skill folder into ~/.claude/skills/ to install.
四套 skill
| # | Skill | 一句话 | 出自 |
|---|---|---|---|
| 1 | single-file-dashboard | 把表格数据做成「一个 HTML 文件就是全部」的可传播看板——双击即开、离线可用、密码访问、数据加密、单元格就地可改 | DMA 分区水损看板 · 供水数据看板 |
| 2 | excel-data-pipeline | 把真实台账提取成一份可辩护的 JSON——先探结构、列契约校验、父子合计口径、异常值处理 | 两个看板共用的数据层 |
| 3 | html-slide-report | 用一份 HTML 做汇报幻灯,再导出 PDF 与 PPTX——现场能讲、能打印、能发出去 | 降低产销差专项工作汇报 |
| 4 | share-doc-pipeline | 把做完的项目整理成可对外发布的总结文档——脚本生成 Word、截图前自动脱敏、渲染校验 | 本轮的文档分享工作本身 |
怎么读:想做什么事,看对应那份 SKILL.md;里面会指到 references/ 和 scripts/ 的具体文件。
安装
每个 skill 都是标准目录结构,三种用法挑一种:
① 装进 Claude Code(推荐)——把 skill 文件夹复制到 skills 目录,Claude 会在合适的场景自动调用:
git clone https://github.com/1231Johnny/claude-skills.git
cp -r claude-skills/single-file-dashboard ~/.claude/skills/
② 直接下载 zip——不想克隆的话,到 Releases 页一键下载;四份打包好的 zip 也在本仓库 dist/ 里。
③ 当参考文档读——SKILL.md 里的「常见坑」表和 references/ 里的规范,本身就是独立的经验总结,不装 Claude 也能看。
脚本依赖写在各自的文件头注释里,都是常见库(
openpyxl、playwright、xlsx),不引入非必要的依赖。
效果示例
四张示例图放在 examples/,每张 1440×960、按 2 倍导出。同时各复制了一份到对应 skill 的 assets/preview.png,打包时随 zip 一起走。
| ① 单文件数据看板 | ② 台账提取与口径校验 |
|---|---|
| 密码门 · KPI · 原生 SVG 折线图 · 就地可改的单元格 | 左是源表里的三个坑,右是脚本自己说清的口径 |
| ③ HTML 幻灯汇报 | ④ 总结文档与对外分享 |
| 全屏吸附翻页 · 一份源文件导出 PDF 与 PPTX | 截图前后对照 · 三层脱敏 · 交付流水线 |
图里的数据是示例数据,主体名一律是「某…」「片区A」——和 skill 正文同一套脱敏口径。 要改图:编辑
examples/src/*.html,然后python examples/shoot.py重新出图(脚本会顺带检查有没有内容被裁掉)。
为什么是这四个,不是按项目拆
按项目拆会得到四套互相重复的东西——四个项目里都在做「读 Excel」「做单文件 HTML」「配图」,只是应用场景不同。
按能力拆之后,别人手上有任意一份台账都能用上其中某一套,复用面宽得多。每套 skill 里都注明了它的做法出自哪个项目,溯源不会丢。
数据层单独抽成第 2 套,是因为它是第 1、3 套的共同前置,而且它管的是最容易出错、最容易被追问的部分——数字对不对。把它独立出来,才能讲透。
通用约定
四套 skill 共同遵守的几条:
- 主体名一律隐去。单位全称、地名、小区名、编号、密钥在示例与文档里全部替换成「某…」「片区A」;数值和技术方案保留。
- 脚本开箱即跑。依赖写在脚本注释里,不引入非必要的库。
- 踩坑写在明面上。每套 skill 都有一节「常见坑」,格式是「现象 → 原因 → 处理」。这些是最省时间的内容。
- 中文输出注意编码。Python 脚本开头统一
sys.stdout.reconfigure(encoding='utf-8', errors='replace');PowerShell 脚本存成 UTF-8 with BOM。
重新打包
改完 skill 要重新出 zip 时:
# ⚠ Windows 上必须加 PYTHONUTF8=1
# 上游的校验脚本用 read_text() 读文件,不指定编码;Windows 默认是 GBK,
# 遇到中文 SKILL.md 会直接抛 UnicodeDecodeError。UTF-8 模式可以绕开,无需改上游脚本。
PYTHONUTF8=1 python ~/.agents/skills/skill-creator/scripts/quick_validate.py single-file-dashboard
PYTHONUTF8=1 python ~/.agents/skills/skill-creator/scripts/package_skill.py single-file-dashboard ./dist
package_skill.py 会先校验 SKILL.md 的 frontmatter 与目录结构,通过后生成 <skill-name>.zip。
打包前记得清理:删掉
scripts/下的__pycache__、node_modules,以及任何跑测试留下的输出文件。
后续怎么维护
见 技能总结与维护指南——里面写了这轮是怎么抽的、下次有新项目时按什么顺序做、以及每套 skill 该在什么时候更新。