Agent skill

Refactor

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

— description from SKILL.md by open-guji

Apache-2.0Auto-check passedDevelopment

Install Refactor

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a claude-code

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

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor --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/refactor .claude/skills/refactor && 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/

Paste into Claude Code

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .claude/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .agents/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .cursor/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/open-guji/luatex-cn.git --path .claude/skills/refactor

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .gemini/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

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

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .github/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add open-guji/luatex-cn --skill refactor -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install open-guji/luatex-cn refactor --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

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

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "refactor" agent skill from https://github.com/open-guji/luatex-cn/tree/main/.claude/skills/refactor into .opencode/skills/refactor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "refactor", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: refactor
GitHub stars: 118
Token cost: ~532 tokens
SKILL.md length: 160 words
Files: 1
Skills in repo: 7
Repo updated: Oct 2, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Works in 10 steps: 删除死代码 → 提取重复代码 → 逻辑迁移：STY → Lua → …
SKILL.md covers 重构原则, 执行流程, 如何选择重构目标 and 注意事项
Calls git and python3

About this skill

Refactor is a skill in open-guji/luatex-cn (118 stars). Its SKILL.md is about 532 tokens. Licence: Apache-2.0.

Workflow steps

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

删除死代码
提取重复代码
逻辑迁移：STY → Lua
使用 Style Stack 管理样式
模块职责单一
文件大小控制
命令复用
分析 (不改代码)
逐步执行
最终验证

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:
- git
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
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

Refactor loads about 532 tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 160 words of instructions outside code blocks.

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

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). 160 words, ~532 tokens.

Download SKILL.mdSave it as .claude/skills/refactor/SKILL.md (or your agent's skills folder).

name: refactor
description: 清理重构代码 (Code cleanup and refactoring)

代码清理与重构

以资深程序架构师的视角审视项目代码，使其更整洁、更模块化、更易维护。

重构原则

按优先级排列：

1. 删除死代码

找出未被调用的函数和未使用的变量
搜索方式：用 Grep 搜索函数名/变量名，确认只有定义没有调用
Lua 文件：检查 local function 和 module 导出的函数
STY 文件：检查 \cs_new 定义的命令是否被使用

2. 提取重复代码

在同一文件或相关文件中找到高度相似的代码段
提取为通用函数，放到合适的工具模块中
命名清晰，参数明确

3. 逻辑迁移：STY → Lua

复杂逻辑应放在 Lua 中，STY 只负责命令定义和参数解析
STY 文件应尽量薄：定义命令 → 调用 Lua 函数

模式：

latex

% STY 中：只做参数解析和 Lua 调用
\NewDocumentCommand{\MyCmd}{O{} m}{
  \lua_now:e { my_module.my_func("\exp_not:n{#1}", "\exp_not:n{#2}") }
}

4. 使用 Style Stack 管理样式

格式和样式的设置应通过 style stack 来管理
避免全局变量传递样式参数
查看 tex/core/ 中 style stack 的现有用法作为参考

5. 模块职责单一

每个模块（文件）负责一个独立功能
与该功能相关的所有代码都应集中在该模块中
如果发现某个功能的代码散落在多个不相关的文件中，应该收拢

6. 文件大小控制

单个文件超过 400~600 行时，必须考虑拆分
按子功能拆分为多个文件
通过 require (Lua) 或 \RequirePackage (STY) 组织

7. 命令复用

如果一个命令可以由其他命令组合实现，优先复用
避免重复实现已有功能

执行流程

Phase 1: 分析 (不改代码)

扫描目标模块
- 读取目标文件，理解其功能和结构
- 统计行数，标记过大的文件
识别问题
- 用 Grep 搜索未使用的函数/变量
- 找出重复代码段
- 标记可以迁移到 Lua 的 STY 逻辑
- 检查模块职责是否单一
制定计划
- 列出所有要做的重构项
- 按风险从低到高排序
- 每个重构项作为独立的一步
- 使用 EnterPlanMode 让用户审批计划

Phase 2: 逐步执行

对每一步重构：

修改代码
- 只做当前这一步的改动
- 保持功能不变
回归测试
bash
```
python3 test/regression_test.py check
```
- 所有测试必须 PASSED
- 如果失败，立即修复或回滚

提交

bash

git add <changed-files>
git commit -m "refactor: <描述这一步做了什么>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"

继续下一步

Phase 3: 最终验证

bash

# 运行完整回归测试
python3 test/regression_test.py check --all

如何选择重构目标

如果用户没有指定目标模块，按以下顺序扫描：

bash

# 找出最大的文件
find tex/ -name '*.lua' -o -name '*.sty' | xargs wc -l | sort -rn | head -20

优先处理：

行数最多的文件
最近频繁修改的文件 (git log --format='%H' --since='2 weeks ago' -- tex/ | head)
已知有技术债的模块

注意事项

不要一次改太多 — 每步只做一个类型的重构
测试优先 — 每步改完必须跑回归测试
保持功能不变 — 重构不改变外部行为
先读 LEARNING.md — 避免踩已知的坑
STY 中的 expl3 — 遇到展开问题先读 ai_must_read/expl3_note.md
不要改测试文件 — 除非测试本身有问题

Files

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

Open the folder on GitHubat commit 8c48bdc

Compare with similar skills

Refactor 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.

Refactor compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Refactor this skillopen-guji/luatex-cn	118	—	~532	Automated safety check: Pass	Apache-2.0	5 days ago
Ss Cpp ModernSerial-Studio/Serial-Studio	7.2k	—	~1.6k	Automated safety check: Pass	Custom licence	today
Guidelinesakash-network/node	1.1k	22 repos	~577	Automated safety check: Pass	MIT	yesterday
Component Refactoringlangflow-ai/langflow	156k	—	~3.5k	Automated safety check: Pass	MIT	today
Migrate Core Code to Submodulestinyhumansai/openhuman	42k	—	~2.6k	Automated safety check: Pass	GPL-3.0	today
Systematic Code Refactoringluongnv89/claude-howto	42k	—	~3k	Automated safety check: Pass	MIT	7 days ago

Similar skills

Ss Cpp Modern
Serial-Studio/Serial-Studio
Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.
7.2k GitHub stars~1.6k tokensUpdated today
DevelopmentAuto-check passed
Guidelines
akash-network/node
Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.
1.1k GitHub starsUsed in 22 repos~577 tokens
DevelopmentAuto-check passed
Component Refactoring
langflow-ai/langflow
Refactor high-complexity React components in Langflow frontend.
156k GitHub stars~3.5k tokensUpdated today
DevelopmentAuto-check passed
Migrate Core Code to Submodules
tinyhumansai/openhuman
Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.
42k GitHub stars~2.6k tokensUpdated today
DevelopmentAuto-check passed
Systematic Code Refactoring
luongnv89/claude-howto
Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.
42k GitHub stars~3k tokensUpdated 7 days ago
DevelopmentAuto-check passed
Codex
skills-directory/skill-codex
A skill your agent uses when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing
1.5k GitHub starsUsed in 3 repos~1.8k tokens
DevelopmentAuto-check passed

Questions about Refactor

How do I install Refactor in Claude Code?

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

How do I install Refactor in Codex?

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

Can I use Refactor 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 refactor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refactor, .gemini/skills/refactor, .github/skills/refactor and .opencode/skills/refactor in your project.

What does Refactor need to run?

Going by SKILL.md and its folder, Refactor needs the command-line tools its instructions call (git and python3).

Does Refactor access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Refactor 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 Refactor use?

Refactor 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 Refactor use?

About 532 tokens (SKILL.md is roughly 2.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 Refactor?

Skills that share tags, products or a category with Refactor: Ss Cpp Modern (Serial-Studio/Serial-Studio, 7.2k stars), Guidelines (akash-network/node, 1.1k stars), Component Refactoring (langflow-ai/langflow, 156k stars) and Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Refactor?

open-guji (a GitHub organization) maintains it in open-guji/luatex-cn, which has 118 GitHub stars. The repository holds 7 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.

Install Refactor

Facts

At a glance

About this skill

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

代码清理与重构

重构原则

1. 删除死代码

2. 提取重复代码

3. 逻辑迁移：STY → Lua

4. 使用 Style Stack 管理样式

5. 模块职责单一

6. 文件大小控制

7. 命令复用

执行流程

Phase 1: 分析 (不改代码)

Phase 2: 逐步执行

Phase 3: 最终验证

如何选择重构目标

注意事项

Files

Compare with similar skills

Similar skills

More from open-guji/luatex-cn

Related

Questions about Refactor