Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

paper

纸 · Paper —— 把一个知识 / 一段内容呈现到一页 A4 纸上,手写体 + 模仿板书,产物极其适合打印。

这是一个 Claude Code 技能(skill):仓库根目录即技能本体(SKILL.md 与同级的 templates/references/),同时本仓库也是一个可一键安装的插件市场。

它能做什么

把一个概念、知识点、笔记浓缩成一张可打印的手写风一页纸。产物是单文件自包含 HTML,所见即所打(精确 210×297mm),背景纹理 / 荧光笔 / 墨色都能打印,内容保证落在一页内。

四种版式

版式 适合 模板
费曼讲解 把一个概念讲到小白能懂(类比 + 要点 + 总结) feynman.html
康奈尔笔记 听课 / 读书笔记,线索栏 + 笔记栏 + 总结 cornell.html
思维速记 / 概念图 一个主题发散出多个分支、知识网络 mindmap.html
速查表 / 知识卡 密集信息速查(命令 / 属性 / 公式 / 快捷键) cheatsheet.html

四种纸张

方格 grid · 点阵 dots · 横线 lines · 空白 blank,通过 <body data-paper="..."> 切换,工具栏也可实时切换。

参考文档

安装

这是一个 Claude Code 技能,安装就是把 paper/ 这个文件夹放进 Claude 的 skills 目录。Claude Code 会自动识别,改动即时生效,无需重启

方式一:用户级(推荐,所有项目都能用)

装到 ~/.claude/skills/,之后在任何项目里都可调用:

git clone --depth 1 https://github.com/linhuiw/paper.git /tmp/paper
mkdir -p ~/.claude/skills/paper
cp -r /tmp/paper/SKILL.md /tmp/paper/templates /tmp/paper/references ~/.claude/skills/paper/
rm -rf /tmp/paper

方式二:项目级(随仓库走,团队共享)

paper/ 放进某个项目的 .claude/skills/ 并提交,克隆该仓库的人就自动拥有:

mkdir -p <你的项目>/.claude/skills/paper
cp -r SKILL.md templates references <你的项目>/.claude/skills/paper/

方式三:插件市场(推荐,一条命令安装 + 自动更新)

本仓库已是一个 Claude Code 插件市场.claude-plugin/marketplace.json),别人在 Claude Code 里执行:

/plugin marketplace add linhuiw/paper
/plugin install paper@linhuiw

装好后技能即可用——自动触发,或手动 /paper:paper(插件技能带市场命名空间)。之后 /plugin marketplace update linhuiw 可拉取更新。

方式四:下载 ZIP(不想用命令行)

在 GitHub 点 Code → Download ZIP 下载并解压,得到一个 paper-…/ 文件夹——它的最外层就是 SKILL.md(以及同级的 templates/references/)。把整个文件夹改名为 paper 放进 ~/.claude/skills/(或项目的 .claude/skills/),或在任何「上传技能文件夹 / ZIP」的入口直接选它即可。

SKILL.md 现已位于仓库顶层,所以不会再出现 SKILL.md must be in the top-level folder, not nested deeper 的报错。

关于 find-skill / 社区注册表:Claude Code 没有官方的 find-skill 命令。社区有 skills.sh / agentskills.io 注册表和 npx skills CLI,但本技能未发布到那里——请用上面三种方式。若想被这类工具收录,需另按其标准提交。

使用

安装后两种触发方式:

  1. 自动触发:说出意图即可,例如「把闭包做成一页纸」「用费曼讲讲 HTTP 缓存」「给我一张 Flexbox 速查表」「整理一张前端性能优化思维导图」。
  2. 手动调用:直接输入 /paper

Claude 会按内容判断版式(费曼 / 康奈尔 / 思维速记 / 速查表),复制对应模板、填好内容,产物默认输出到当前项目的 src/notes/<标题>.html,并给你一个可点击的 file:// 链接。

打印 / 导出 PDF

产物是单文件 HTML,打开后:

  1. 点工具栏 🖨 打印 · 导出 PDF
  2. 在打印对话框里 勾选「背景图形 / Background graphics」(否则纸张纹理和荧光笔不会打印);
  3. 纸张选 A4,边距选 「无 / 默认」

工具栏还能实时切换 纸张(方格 / 点阵 / 横线 / 空白)、字号(A− / A+)、字体(默认 / 徐静蕾)、✍️ 草稿感;右侧 ✓ 一页 / ⚠ 超出一页 是排版守卫提示。

更多细节见 SKILL.md

About

paper

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages