# chinese-content-writing-guideline

Language guidelines for Traditional Chinese content aligned with Taiwan standards. It catches English phrasal verb calques, verifies punctuation, and enforces local technical vocabulary.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 834 installs · ★ 22
- Author: Jim@ChenJ.im
- License: GFDL-1.3-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jim60105/copilot-prompt/tree/HEAD/skills/chinese-content-writing-guideline/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/chinese-content-writing-guideline

## What it does

The skill applies Taiwan linguistic standards (zh-TW) across articles, notes, and technical drafts. It sets boundaries against literal translations of English phrasal verbs, stopping calques such as translating fold in or land directly into word-for-word patterns. Readers encounter proper terminology for concepts like queues or memory, rather than mainland expressions.

Formatting checks demand full-width punctuation and a single space around Latin characters. For pronouns, the guidelines enforce direct reader addresses, ruling out formal honorific markers. When introducing technical concepts in English, the guide requires pairing with the zh-TW translation on first mention, then sticking to the local term.

A bash script at `<skill-dir>/scripts/lint.sh` scans markdown drafts for punctuation errors, repeated terms, and known calques. The script relies on GNU grep with PCRE support, requiring `GREP=ggrep` on macOS. This skill handles language constraints, while structural flow and tone belong to `writing-style-guideline`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jim60105/copilot-prompt --skill chinese-content-writing-guideline -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/chinese-content-writing-guideline/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/chinese-content-writing-guideline/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jim60105/copilot-prompt --skill chinese-content-writing-guideline -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/chinese-content-writing-guideline/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jim60105/copilot-prompt --skill chinese-content-writing-guideline -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/chinese-content-writing-guideline/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jim60105/copilot-prompt chinese-content-writing-guideline
```

2. **Manually: put the files in place**
- File: `.github/skills/chinese-content-writing-guideline/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jim60105/copilot-prompt --skill chinese-content-writing-guideline -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jim60105/copilot-prompt --path skills/chinese-content-writing-guideline
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/chinese-content-writing-guideline/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jim60105/copilot-prompt --skill chinese-content-writing-guideline -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jim60105/copilot-prompt/tree/HEAD/skills/chinese-content-writing-guideline/SKILL.md

## When to use it
- eliminate word-for-word calques of English phrasal verbs
- ensure single spacing between Chinese and alphanumeric characters
- apply Taiwan technical vocabulary instead of mainland terms
- validate draft markdown files using lint.sh

## Example prompts
- Review this draft against Taiwan Traditional Chinese conventions
- Translate this software guide into zh-TW without English calques
- Run `<skill-dir>/scripts/lint.sh draft.md` to check formatting and terminology

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md