npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

latex-paper-skills

v0.1.0

Published

Install a complete ML/AI academic LaTeX paper skill suite for Codex, Claude Code, and other agents

Readme

latex-paper-skills

新手先看:AI 写论文工作流入门

English | 简体中文

可移植的 AI 智能体技能包,用于撰写 ML/AI 学术论文 —— 从选题到编译 PDF,附带已验证的 BibTeX 引用、门禁工作流和多智能体协作。

这个仓库是什么

这个仓库不是某一篇论文的单独工程,而是一套可复用的 AI 学术写作技能包。

这份公开快照主要保留三类内容:

  • .codex/skills/ 下的可复用技能
  • 仓库级工作流文档
  • 两个精选 showcase:一个实证论文,一个综述论文

这份公开仓库刻意不保留大体积本地数据集、机器本地配置和缓存数据库。对实证 showcase 来说,开发阶段实际使用过的原始数据已经移除,但保留下来的代码、结果文件、图和最终 PDF 仍然能说明这个工作流真实完成了“找数据集 → 接入数据 → 运行实验 → 回填论文”的闭环。

状态与测试模型

本仓库的 showcase 使用 GPT-5.2 xhigh 开发和测试。使用 GPT-5.4 效果预计会更好。目前测试用例较少,工作流还有很大的提升空间,当然也不排除存在尚未发现的 bug。

工作原理

可选的多智能体协作:

| 智能体 | 定位 | 工具 | |--------|------|------| | Gemini | 广度 — 文献扩展、关键词聚类、替代框架 | gemini_bridge.py | | Claude | 深度 — 声明压测、证据审计、路由判断 | claude_bridge.py | | 健康检查 | 验证两个 CLI 已安装且 API 可达 | check-collaborators |

技能一览

所有技能位于 .codex/skills/,每个技能包含 SKILL.md(智能体执行的可执行规范),以及可选的 scripts/、assets/、references/。

核心流水线

| 技能 | 功能 | |------|------| | paper-from-zero | 路由层。选题 → 文献搜索 → 创新框架 → 贡献图 → 证据矩阵 → 路由到写作技能。 | | arxiv-paper-writer | 综述论文执行器。门禁 IEEEtran LaTeX 工作流,含 issues CSV 合同、按 issue 写作循环、引用验证和 QA。 | | empirical-paper-writer | 实验论文执行器。在综述工作流基础上增加实验矩阵、结果状态追踪(planned/placeholder/verified)和证据-声明映射。 | | latex-rhythm-refiner | 文本润色器。变化句段节奏、去除填充词,严格保持所有 \cite{} 位置不变。 | | results-backfill | 将真实实验结果回填到现有草稿。替换占位符、将假设升级为事实性表述、生成结果图。 |

协作层

| 技能 | 功能 | |------|------| | collaborating-with-gemini | 广度协作者(Gemini CLI)。结构化 JSON + 会话持久化。 | | collaborating-with-claude | 深度协作者(Claude Code CLI)。声明压测和证据审计。 | | check-collaborators | 健康检查 — 验证 CLI 安装、认证和 API 可达性。 |

门禁工作流

两个写作技能都执行严格的门禁:

快速开始

通过 npx 安装

在论文项目目录运行,选择你使用的智能体:

npx skills@latest add yunshenwuchuxun/latex-paper-skills --skill latex-paper-skills

当前项目安装到 Codex,可跳过交互选择:

npx skills@latest add yunshenwuchuxun/latex-paper-skills --skill latex-paper-skills --agent codex --yes

Claude Code 用户将 --agent codex 换成 --agent claude-code;全局安装追加 --global。安装后可直接说:Use latex-paper-skills. My topic is: <你的主题>。 这里使用现有的 Skills CLI,无需另发 npm 包,使用者也无需 npm 账号。

安装目录 skills/latex-paper-skills/ 内含全部 8 个工作流、_shared、脚本和 模板。请选择完整包:单独安装 .codex/skills/ 下的源码技能会遗漏跨目录 依赖。开发源码仍位于 .codex/skills/;修改后运行 python3 scripts/build_distribution.py 重新生成安装包。 各平台发布方式见分发与发布说明。

独立 npm 包

仓库已具备 npm 包 latex-paper-skills 的发布配置,包含完整技能和安装命令。 发布到 npm 后可直接运行:

npx latex-paper-skills --agent codex --yes
npx latex-paper-skills --agent claude-code --global

安装器需要 Node.js 22.20.0+,完整保留技能的共享依赖,没有安装生命周期脚本。 维护者可用 npm pack --pack-destination dist 生成发行包;发布步骤见 npm 分发说明。

平台市场

前置要求

  • Python 3.10+
  • LaTeX 环境(pdflatex + bibtex,或 latexmk)
  • 能读取 SKILL.md 的 AI 智能体运行时(Codex CLI、Claude Code 等)

完整流水线(选题 → PDF)

Use the paper-from-zero skill. My topic is: <你的研究主题>

直接写综述论文

Use the arxiv-paper-writer skill. Write a review article about <主题>.

直接写实验论文

Use the empirical-paper-writer skill. Write an experimental paper about <主题>.

调用模板:指定数据集与云平台运行

你可以在自然语言里直接指定数据集、算力预算和目标云平台。

Use the empirical-paper-writer skill.
Topic: <主题>.
Mandatory datasets: <数据集 A>, <数据集 B>.
Primary dataset: <数据集 A>.
Do not use private data.
Design a compute-aware experiment plan for a single A100 80GB.
Use the empirical-paper-writer skill.
Topic: <主题>.
Dataset: <数据集名称> from local path <路径>.
Target runtime: cloud A100 x1, max 8 hours.
Need a local smoke run first, then a full cloud run.
Keep the claims bounded by this compute budget.
Use the empirical-paper-writer skill.
Topic: <主题>.
Mandatory datasets: <数据集名称>.
Target platform: AutoDL / Lambda / Slurm cluster.
Generate experiments/, configs/default.yaml, and an experiments README for cloud execution.
Assume I will run the jobs myself and then use results-backfill after real CSVs are available.

说明:

  • 这个 skill 可以按你的数据集和算力预算来设计实验。
  • 这个 skill 不会自动替你开云主机或提交云端任务。
  • 真实结果仍然需要在 AI 会话外跑出,并写入 paper/results/。

共享脚本引擎

.codex/skills/arxiv-paper-writer/scripts/ 包含两个写作技能共用的核心脚本:

| 脚本 | 用途 | |------|------| | arxiv_registry.py | arXiv 元数据/BibTeX 缓存(SQLite) | | compile_paper.py | LaTeX 编译(latexmk 或 pdflatex+bibtex) | | citation_policy.py | 引用审计(bib/tex 一致性、lint) | | source_ranker.py | 来源质量评分 | | style_profile.py | 目标期刊/会议风格检查 | | issue_workflow.py | Issue 执行辅助 | | bootstrap_ieee_review_paper.py | 搭建 IEEEtran 项目骨架 | | create_paper_plan.py | 从大纲生成论文计划 | | validate_paper_issues.py | 校验 issues CSV 完整性 |

跨技能共享工具(paper_utils.py、source_policy_utils.py)位于 .codex/skills/_shared/。

不可违反的规则

  • 审批前不写正文 — main.tex 在计划获批且 issues CSV 存在前只保留骨架。
  • Issues CSV 是合同 — 按 issue 更新状态;仅在满足验收标准时标记 DONE。
  • 引用必须验证 — 每条引用在写入 ref.bib 前都要通过在线来源核实。
  • 严禁捏造 引用、结果或显著性声明。

公开 Showcase

这份公开仓库只保留两个精选项目:

| 项目 | 类型 | 它展示了什么 | 建议先看 | |------|------|--------------|----------| | projects/rt-inflow-forecast-closed-loop | 实证论文 | 选题框架、实验设计工件、本地数据集接入、已验证结果文件、结果图,以及回填后的论文 | README.md、paper/main.pdf、paper/results/、experiments/README.md | | projects/peft-survey-2022-2026 | 综述论文 | 选题框架、plan 审批、issues 驱动写作、文献组织、引用核验后的综述草稿与最终论文 | README.md、main.pdf、plan/、issues/ |

如果你只想最快看明白:

  1. 先看 projects/rt-inflow-forecast-closed-loop/README.md,理解实证路线。
  2. 再看 projects/peft-survey-2022-2026/README.md,理解综述路线。
  3. 想看完整工作流解释,再读 BEGINNER_WORKFLOW.zh-CN.md。

项目结构

latex-paper-skills/
├── .codex/skills/
│   ├── paper-from-zero/              # 路由层:选题 → 写作技能
│   ├── arxiv-paper-writer/           # 综述论文执行器 + 共享脚本
│   ├── empirical-paper-writer/       # 实验论文执行器
│   ├── results-backfill/             # 将真实结果回填到草稿
│   ├── latex-rhythm-refiner/         # 文本润色器
│   ├── collaborating-with-claude/    # Claude Code 桥接
│   ├── collaborating-with-gemini/    # Gemini CLI 桥接
│   ├── check-collaborators/          # CLI 健康检查
│   ├── _shared/                      # 跨技能共享工具
│   └── _orchestration/               # 工作流编排配置
├── projects/
│   ├── rt-inflow-forecast-closed-loop/  # 实证论文 showcase
│   └── peft-survey-2022-2026/           # 综述论文 showcase
├── picture/                          # README 用 SVG 图表
├── ARCHITECTURE.md                   # 详细架构分析
├── BEGINNER_WORKFLOW.zh-CN.md        # 工作流入门指南
├── README.md
└── README.zh-CN.md

相关

Star History

License

本仓库采用 MIT License。