ClaudeMap

minorun-marp-skill

三个日文 Marp 演示技能,配一套黑底青色主题和五个实测脚本,专抓肉眼看不出的排版问题。

技能与命令marpslidespresentationthemeqa-scripts

作者 @minorun365 制作自己登坛资料时反复纠正 AI 的地方,被这套包沉淀成了规则与检查脚本。slide-story 讲叙事:开场抓手、章节隔页、渐进披露、标题文体、收尾方式与时长估算;slide-figures 讲图:压缩信息量、SVG 画法、字号下限、插图的摆放;slide-design-dark 讲留白测量、纵向平衡、黑底配色、表格与代码样式,以及 Marp 的各种坑。自带黑底青色点缀的主题;工具脚本实测导出的 PDF 与 SVG——下端与右端留白、图与正文间距、图内小字、SVG 文字出框、复用幻灯片的标题与图错位。

它做什么

  • 三个技能直接拷进 ~/.claude/skills/:slide-story(叙事骨架)、slide-figures(图与 SVG)、slide-design-dark(暗色排版与 Marp 的坑)
  • 五个检查工具配一个故意做坏的示例库(examples/broken),用来证明每项检查真的会响:check-dark-margins.py、check-dark-gaps.py、check-figure-text.py、check-svg-box-fit.mjs、check-reuse-diff.py
  • theme/minorun-dark.css——黑底青色点缀的 Marp 主题,为圆体黑体字设计(首选 Zen Maru Gothic,macOS 未装时回退 Hiragino 丸黑)
  • 人也能直接读:作者说明这些规则本身就是普通的做片方法,不只是给 agent 的指令

什么时候用

用 Claude Code 出 Marp 片、又受够了「排版工整但内容单薄」的人:让技能定叙事,再让脚本量出投影仪真正会惩罚的东西——下边距拥挤、图与正文贴太近、SVG 里小到看不清的字。

如何上手

git clone https://github.com/minorun365/minorun-marp-skill.git
cp -r minorun-marp-skill/skills/* ~/.claude/skills/
# theme/ 与 tools/ 拷进放幻灯片的仓库
cd minorun-marp-skill && npm i -g @marp-team/marp-cli
marp --no-stdin deck.md --pdf --theme theme/minorun-dark.css --allow-local-files
python3 tools/check-dark-margins.py deck.pdf

注意事项

技能、文档与注释都是日文——Claude Code 读起来没问题,但要自己改就需要懂日文。检查链需要 Marp CLI + Google Chrome、poppler(pdftoppm/pdfinfo)、mupdf-tools(mutool)、带 Pillow 的 Python 3;check-svg-box-fit.mjs 借用 Marp CLI 自带的 puppeteer-core(位置不同用 MARP_NODE_MODULES / CHROME_PATH 指定)。示例库插图是いらすとや的素材:不随包分发、不在本许可证内——需另行获取并自行确认使用条件。作者自己的片子用的是收费圆体字,公开示例的字形会略有差异。Apache-2.0。

代码仓库

minorun365/minorun-marp-skill

收录日期

地图上的相关资源

  • 归藏的 Agent Skill:把代码库的最近更新做成一支成片宣传片——接真实组件、代码渲染动画、代码写配乐,全程不碰视频剪辑软件。

    • agent-skill
    • video
    • promo
    • marketing
  • 一个给「图里没有任何文字线索」的照片做地理定位的 Agent Skill——用 OSM 几何、高程天际线与卫星瓦片,把「这是哪」变成带误差半径的测量答案。

    • agent-skill
    • geolocation
    • osint
    • openstreetmap
  • Birdview

    技能

    让 AI 编码 agent 在动第一行代码之前先画出架构、声明影响范围的 skill——成果是一张可直接打开的独立 HTML 架构地图。

    • skill
    • architecture
    • code-visualization
    • change-scope