My Skills

My personal ~/.skills repo — the SKILL.md skills, scripts, and tooling I use day to day across Claude Code, Cursor, and Codex. It's a personal toolbox, not a single-purpose product: it grows in whatever direction my work needs, and anything here is public because it might be useful to someone else too.

Today the skills lean toward Traditional Chinese writing — de-AI editing, Taiwan localization, business documents — because that's the gap almost nothing on GitHub covers: writing that reads natural to a Taiwan audience, stripped of the AI tells, mainland-China wording, and corporate jargon that give machine text away. Other skills and tools live alongside them, and more get added over time.

Most AI-writing tooling assumes English. For a Taiwan audience it leaves gaps these skills close:

• English-only defaults. De-AI editors, tone checkers, and style tools are tuned for English and miss the tells in Chinese entirely.
• Generic zh, not Taiwan zh. "Chinese" support usually means mainland usage. These write the way people actually write in Taiwan.
• Leaked mainland wording & Simplified. 陸用語, 互聯網黑話, and stray 簡體字 slip into Traditional Chinese; the localizer catches them without over-correcting real terms.
• AI tells & corporate jargon. The uniform rhythm, hedging, and filler that give machine text away — stripped, in both languages.

• Portable by design. Every skill runs on Claude Code and Codex (and any agentskills.io-compatible agent). No external tools or APIs required; tool-specific power is never load-bearing.
• Self-sufficient. Each skill does its own job standalone; sibling skills are optional pointers, never prerequisites.
• Earns its place. A skill ships only if it beats its no-skill baseline on a real eval. No bar-clearing eval, no skill.
• Currently writing-heavy. The catalog below is Taiwan-first Chinese writing — de-AI editing, 陸用語 → 台灣用語 localization, plain-language rewrites, blogs, and 簽呈/RFP/評估報告 docs. Scope is open, not fixed.
• Two that travel further. infographic-design (design-system-grade explanatory graphics) and knowledge-doc-writing (the Diátaxis documentation discipline) are professional, language-agnostic tools that stand on their own — no Chinese required.

Two paths — a networked one-liner, or offline per-skill symlinks (below).

Install every skill onto a machine with one command:

npx skills add https://github.com/leoluyi/skills -g -a '*' -y

Update later:

npx skills update --all

Then in Claude Code / Cursor / Codex, just describe the task — a skill's trigger fires it automatically. For example: "幫我把這段 README 去掉 AI 味" loads humanizer-zh.

git clone git@github.com:leoluyi/skills.git ~/.skills
cd ~/.skills
tools/sync-skills

24 skills across 7 categories. Every skill is labelled model-invoked (the agent fires it automatically on a matching task, and you can also call it by name) or user-invoked (only you can, by name). Browse the interactive catalog ↗ or read any SKILL.md directly.

Language-agnostic professional tools that stand on their own — no Chinese required.

Language-agnostic; runs on any agent with shell access.

Language-agnostic; runs on any agent that can execute a plan unattended.

Clone the repo and wire it into Claude Code for local authoring:

git clone git@github.com:leoluyi/skills.git ~/.skills
cd ~/.skills
tools/sync-skills

.
├── README.md
├── README.zh-TW.md    # Traditional Chinese README
├── CLAUDE.md          # hard rules (always loaded) — the forbidden directives
├── engineering-guidelines.md     # full authoring guide
├── CONTRIBUTING.md    # how to contribute (EN + 繁中)
├── backlog.md         # repo-level + tools/ backlog (per-skill items live in skills/<name>/backlog.md)
├── skills/            # active skills — each is a SKILL.md folder
├── docs/              # GitHub Pages site (the live catalog)
└── tools/             # repo scripts

The hard, always-loaded rules are in CLAUDE.md. The full authoring guide — anatomy, frontmatter gotchas, naming, portability, and test discipline — is in engineering-guidelines.md. To contribute, start with CONTRIBUTING.md.

MIT © Lu Yi. Individual skills that build on third-party work carry their own LICENSE/NOTICE and are credited below.

Some skills stand on prior work. Credit and licenses:

• speak-human-tw by Raymond Hou (雷蒙三十) (MIT) — humanizer-zh adapts its six-step working procedure and its 保護清單 mechanism, and its 翻譯腔 patterns informed Taiwan-usage entries in that skill and in avoid-china-writing (陸用語 term table); those rule entries are our own rewrite, not copied text. Separately, humanizer-zh's eval corpus (evals/evals.json ids 15-54) adapts 40 of its test cases verbatim, with attribution — see skills/humanizer-zh/NOTICE.
• humanizer by Siqi Chen (MIT) and x-skills' x-humanizer by Sergey Bulaev (MIT) — humanizer-zh's English layer was distilled from their pattern inventories; the patterns were re-derived, re-classified into that skill's own defect classes, and rewritten, with no prose copied verbatim.
• avoid-ai-writing by Conor Bronsdon (MIT) — humanizer-zh through v1.5.0 rebased its English detection layer verbatim from this project. That layer was removed in v2.0.0 and no longer appears in the skill; the credit stands for the record.
• Diátaxis by Daniele Procida (CC BY-SA 4.0) — knowledge-doc-writing is structured on the Diátaxis four-type model (tutorial / how-to / reference / explanation). The framework is Procida's work; the distilled study notes under skills/knowledge-doc-writing/research/ are a derivative and are made available under CC BY-SA 4.0.
• frontend-design by Anthropic (Apache-2.0) — infographic-design adapts portions; see skills/infographic-design/NOTICE.