Agent skill

Test Tex

by open-guji in open-guji/luatex-cn

通过回归测试框架编译并查看 TeX 文件的渲染效果,避免在工作目录生成多余 PDF. An agent skill from open-guji/luatex-cn.

Apache-2.0Auto-check passedDocuments & Office

Install Test Tex

skills CLI
$ npx skills add open-guji/luatex-cn --skill test-tex -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install open-guji/luatex-cn test-tex --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/open-guji/luatex-cn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/test-tex .claude/skills/test-tex && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
test-tex
GitHub stars
119
Token cost
~278 tokens
SKILL.md length
76 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

通过回归测试框架编译并查看 TeX 文件的渲染效果,避免在工作目录生成多余 PDF. An agent skill from open-guji/luatex-cn.

  • Works in 4 steps: 确定测试文件 → 编译并生成 PNG → 查看渲染结果 → …
  • Tasks that involve LaTeX
  • SKILL.md covers 参数, 工作流程 and 注意事项
  • Calls python3

What it does

Test Tex is an agent skill from open-guji/luatex-cn. 通过回归测试框架编译并查看 TeX 文件的渲染效果,避免在工作目录生成多余 PDF

Its SKILL.md is about 280 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering LaTeX. The repository describes itself as: 基于LuaTeX的中文排版宏包,支持古籍版式精确复刻,以及符合W3C《中文排版需求》的现代中文排版. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve LaTeX

Example prompts

  • “/test-tex”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 确定测试文件
  2. 编译并生成 PNG
  3. 查看渲染结果
  4. 清理临时文件

What it can do on your machine

Read from SKILL.md and the folder at commit 8c48bdc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Test Tex loads about 278 tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 76 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~13
When it runs · the whole SKILL.md, loaded when a task matches
~278

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from open-guji/luatex-cn at commit 8c48bdc, republished under its Apache-2.0 licence (© open-guji). 76 words, ~278 tokens.

Download SKILL.mdSave it as .claude/skills/test-tex/SKILL.md (or your agent's skills folder).
name
test-tex
description
通过回归测试框架编译并查看 TeX 文件的渲染效果,避免在工作目录生成多余 PDF

测试 TeX 文件

当需要编译并查看某个 TeX 文件的渲染效果时,必须通过回归测试框架来执行,避免在工作目录中生成多余的 PDF 文件。

参数

  • $ARGUMENTS:要测试的 tex 文件路径或名称(可选,如果不提供则根据上下文判断)

工作流程

1. 确定测试文件
  • 已有文件:如果 test/regression_test/tex/ 下已存在该文件,直接使用
  • 临时测试:如果需要创建临时 tex 文件,将其写入 test/regression_test/tex/ 目录下,文件名以 _tmp_ 前缀标记(如 _tmp_test.tex)
2. 编译并生成 PNG
bash
python3 test/regression_test.py check test/regression_test/tex/<文件名>.tex

这会:

  • 编译 TeX 文件生成 PDF
  • 将 PDF 所有页面转换为 PNG(300dpi)
  • PNG 保存在 test/regression_test/current/ 目录下
  • 如果有基线则进行对比,没有基线也会生成 PNG
3. 查看渲染结果

使用 Read 工具读取生成的 PNG 文件来查看效果:

test/regression_test/current/<文件名>-1.png  # 第1页
test/regression_test/current/<文件名>-2.png  # 第2页
...
4. 清理临时文件

测试完成后,必须删除临时生成的 tex 文件(以 _tmp_ 前缀标记的文件):

bash
rm test/regression_test/tex/_tmp_*.tex

test/regression_test/tex/ 目录下只保留需要长期持续回归验证的测试文件。

注意事项

  • 禁止在其他目录中直接运行 lualatex 编译生成 PDF
  • 禁止使用 pdftoppm 等工具手动转换,统一由回归测试框架处理
  • 临时文件用 _tmp_ 前缀,便于识别和清理
  • 如果测试结果正确且需要长期保留,去掉 _tmp_ 前缀并用 save 保存基线

© open-guji, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/test-tex of open-guji/luatex-cn.

Open the folder on GitHubat commit 8c48bdc

Compare with similar skills

Test Tex next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Test Tex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Tex this skillopen-guji/luatex-cn119—~278Automated safety check: PassApache-2.0
Research Writingalfonso0512/research-writing-skill4881 repos~818Automated safety check: PassMIT
Paper WritingMLNLP-World/Paper-Writing-Tips4.7k—~630Automated safety check: PassNone
Evomath TaoEvoScientist/EvoSkills4762 repos~3.8kAutomated safety check: PassApache-2.0
Math Modeling to EI Conference Paperjihe520/MathModelAgent6.2k—~688Automated safety check: PassNone
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT

Similar skills

  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    488 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed
  • Paper Writing

    MLNLP-World/Paper-Writing-Tips

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    4.7k GitHub stars~630 tokensUpdated 13 days ago
    Documents & OfficeAuto-check passed
  • Evomath Tao

    EvoScientist/EvoSkills

    A skill your agent uses whenever the user submits a non-trivial mathematical claim that needs a rigorous proof or audit.

    476 GitHub starsUsed in 2 repos~3.8k tokens
    Documents & OfficeAuto-check passed
  • Rewrites a math modeling competition paper into an English EI conference submission, using a bundled IEEE LaTeX template, with evidence tracked back to the original paper.

    6.2k GitHub stars~688 tokensUpdated 6 days ago
    Documents & OfficeAuto-check passed
  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Compiledeck

    scunning1975/MixtapeTools

    Create and compile beautiful Beamer presentations following the Rhetoric of Decks philosophy.

    473 GitHub starsUsed in 2 repos~3.1k tokens
    Documents & OfficeAuto-check passed

More from open-guji/luatex-cn

All 8 skills in this repo
  • Compare Layouts

    open-guji/luatex-cn

    比较 Original (ltc-guji.cls) 和 Digital (ltc-guji-digital.cls) TeX 文件的 layout 输出

    119 GitHub stars~550 tokensUpdated 7 days ago
    Auto-check passed
  • Convert To Digital

    open-guji/luatex-cn

    将 ltc-guji.cls 文件转换为 ltc-guji-digital 格式. An agent skill from open-guji/luatex-cn.

    119 GitHub stars~747 tokensUpdated 7 days ago
    Auto-check passed
  • Prepare Next Version

    open-guji/luatex-cn

    准备下一个补丁版本 (Prepare next patch version release). An agent skill from open-guji/luatex-cn.

    119 GitHub stars~412 tokensUpdated 7 days ago
    Auto-check passed
  • Regression Test

    open-guji/luatex-cn

    运行视觉回归测试验证代码更改是否正确,支持 basic/pastissue/complete 套件及基线更新. An agent skill from open-guji/luatex-cn.

    119 GitHub stars~350 tokensUpdated 7 days ago
    Auto-check passed
  • Fix GitHub Issue

    open-guji/luatex-cn

    修复 GitHub Issue 的完整工作流

    119 GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed
  • Refactor

    open-guji/luatex-cn

    清理重构代码 (Code cleanup and refactoring)

    119 GitHub stars~532 tokensUpdated 7 days ago
    Auto-check passed

Questions about Test Tex

What does Test Tex do?

通过回归测试框架编译并查看 TeX 文件的渲染效果,避免在工作目录生成多余 PDF. An agent skill from open-guji/luatex-cn. Test Tex is an agent skill from open-guji/luatex-cn.

When should I use Test Tex?

Test Tex fits situations like: tasks that involve LaTeX.

How do I install Test Tex in Claude Code?

Run `npx skills add open-guji/luatex-cn --skill test-tex -a claude-code`. Or copy the skill folder (.claude/skills/test-tex in open-guji/luatex-cn) into .claude/skills/test-tex in your project. Claude Code loads it when a task matches its description.

How do I install Test Tex in Codex?

Run `npx skills add open-guji/luatex-cn --skill test-tex -a codex`. Or copy the skill folder (.claude/skills/test-tex in open-guji/luatex-cn) into .agents/skills/test-tex in your project. Codex loads it when a task matches its description.

Can I use Test Tex in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add open-guji/luatex-cn --skill test-tex -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/test-tex, .gemini/skills/test-tex, .github/skills/test-tex and .opencode/skills/test-tex in your project.

What does Test Tex need to run?

Going by SKILL.md and its folder, Test Tex needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Test Tex access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Test Tex safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Test Tex use?

Test Tex is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Test Tex use?

About 278 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Test Tex?

Skills that share tags, products or a category with Test Tex: Research Writing (alfonso0512/research-writing-skill, 488 stars), Paper Writing (MLNLP-World/Paper-Writing-Tips, 4.7k stars), Evomath Tao (EvoScientist/EvoSkills, 476 stars) and Math Modeling to EI Conference Paper (jihe520/MathModelAgent, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Tex?

open-guji (a GitHub organization) maintains it in open-guji/luatex-cn, which has 119 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 2, 2026.

Source: open-guji/luatex-cn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.