Chinese Technical Writing
leter/zh-tech-writing
Sets writing rules for Chinese technical docs: short plain sentences, consistent typography and a checklist for removing AI-sounding filler.
Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.
SKILL.md written in Japanese; this summary is our English description.
$ npx skills add coji/natural-japanese --skill natural-japanese -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install coji/natural-japanese natural-japanese --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/natural-japanese .claude/skills/natural-japanese && rm -rf skills-srcUse ~/.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/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .claude/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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 install https://github.com/coji/natural-japanese/tree/main/skills/natural-japaneseType 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.
$ npx skills add coji/natural-japanese --skill natural-japanese -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install coji/natural-japanese natural-japanese --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/natural-japanese .agents/skills/natural-japanese && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .agents/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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.
$ npx skills add coji/natural-japanese --skill natural-japanese -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install coji/natural-japanese natural-japanese --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/natural-japanese .cursor/skills/natural-japanese && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .cursor/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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 https://github.com/coji/natural-japanese.git --path skills/natural-japanese--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add coji/natural-japanese --skill natural-japanese -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install coji/natural-japanese natural-japanese --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/natural-japanese .gemini/skills/natural-japanese && rm -rf skills-srcUse ~/.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/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .gemini/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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.
$ gh skill install coji/natural-japanese natural-japaneseInstalls 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).
$ npx skills add coji/natural-japanese --skill natural-japanese -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/natural-japanese .github/skills/natural-japanese && rm -rf skills-srcUse ~/.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/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .github/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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.
$ npx skills add coji/natural-japanese --skill natural-japanese -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install coji/natural-japanese natural-japanese --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/coji/natural-japanese.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/natural-japanese .opencode/skills/natural-japanese && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "natural-japanese" agent skill from https://github.com/coji/natural-japanese/tree/main/skills/natural-japanese into .opencode/skills/natural-japanese/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "natural-japanese", 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.
natural-japaneseWrites and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.
The skill targets everyday Japanese work documents: minutes, including ones built from a transcript, research and analysis reports, internal guides, memos, proposals, emails and slide outlines, as well as note articles, blog posts and essays. Its design rests on two ideas: a machine detects suspect phrasing while the agent decides what to change, and preventing awkward text through design and constraints before writing beats cleaning it up afterward. The process runs design, writing, checking and convergence.
Quick mode is the default and runs in place with one lint pass and a read-through, while full mode adds outline and terminology checks plus three parallel subagent reviews for structure, readability and document-type fit. Calling `/natural-japanese` with `write` starts a document from scratch, and `score` gives a naturalness score from 0 to 100 with reasons and no rewrite, after reading `references/diagnose.md`. Reference files cover document types, forbidden patterns, readability and translation-style phrasing, and a template can capture your own style. Technical chapter structure and Markdown formatting are out of scope.
7 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 9a78a42. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
uvFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Natural Japanese Business Writing loads about 2.1k tokens when it runs, and up to ~49k if it reads all its reference files. Until then it costs about 194 tokens; SKILL.md has 303 words of instructions outside code blocks.
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.
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); the scripts in this folder are not scanned.
The full file from coji/natural-japanese at commit 9a78a42, republished under its MIT licence (© coji). 303 words, ~2,081 tokens.
.claude/skills/natural-japanese/SKILL.md (or your agent's skills folder). This skill also uses 27 other files; get the full folder from GitHub.仕事の日本語を、読みやすくわかりやすく書くためのスキル。議事録・調査レポート・社内ガイド・リサーチメモ・スライドといった仕事の文書から、note・ブログ・エッセイまで。AI臭さの除去は工程の一部として組み込まれている。
軸は二つ。第一に「検出は機械、判断はAI」。AIは自分の癖を認識しにくいから、疑いの検出は機械が決定的に行い、直すかどうかはAI(あなた)が文脈で判断する。第二に「事後修正より生成時制約」。書いた後にAI臭を消すより、書く前の設計と書くときの制約で発生自体を防ぐほうが効く。工程は「設計 → 執筆 → 検査 → 収束」の順に進む。
同じ工程を、かける手間の異なる2つのモードで回す。所要時間の実測目安——クイックは短い文書(会議メモ程度)で30秒前後、長め(1万字級)でも3分程度。フルは短い文書で7分前後、1万字級で15〜20分。フルを始めるときは、この目安をユーザーに一言伝えてから着手する。
クイック(既定): 日常の文書はこちら。サブエージェントを使わず、この場で完結させる。追加で読むのは該当する doctype の型1ファイルだけでよい(文体憲法は§2の要約で足りる。他の references は lint の finding が出て判断に迷ったときだけ開く)。設計(§1)は読者・主メッセージ・見出しの確認を頭の中で済ませる。検査は lint を1回と、自分でのスケルトン通読。lint は文書が短くても省略しない(短文では統計系検出器が沈黙するが、禁止語・翻訳調は文1つでも検出される。数秒の保険であり、これを飛ばした時点でクイックの品質保証は成立しない)。収束ループは新規 finding が出なければ1周で切り上げ、最終パスの通読をして終える。スキルによる追加時間は数十秒に収まるはずで、それを超えて references を読み込みはじめたらフルモードの仕事をしている。
フル: ユーザーが「しっかり」「ちゃんと」「時間をかけていい」と言ったとき、対外・経営向けなど失敗コストが高い文書、または長い文書(目安1万字超)のとき。フルと決めたら(またはユーザーがフルを指定したら)、文書が小さくても工程を省略しない。lint に加えて outline / terms も実行し、検査(§4)の三つのレビュー——構造レビュー・読みやすさレビュー・doctype照合——を並列のサブエージェントで必ず行う(各自が所見を返し、判断台帳への統合と「直す/残す」の判断は必ず親が行う。執筆そのものは分割しない——濃淡・比喩の一貫・章間の接続は文書全体を見ないと守れない)。収束は状態条件(§5)を満たすまで回す。「この文書には過剰」と感じても、工程を勝手に間引かず、クイックへの切り替えをユーザーに提案する。なお実測で、思考予算(effort)を低く絞った実行はフルの工程を合理化で削りやすいことが確認されている。effort を選べる環境でフルを実行するなら high を推奨する(クイックは low で十分)。
どちらか迷ったら、まずクイックで仕上げてから「フルで磨き直すこともできる」とユーザーに一言添えるのがよい。
スキルがコマンドとして引数つきで呼ばれた場合、次の形を解釈する。
/natural-japanese [quick|full] <対象> — 書く・直す(既定)。新規作成かリライトかは対象から判断する/natural-japanese write [quick|full] <お題や素材> — 新規作成を明示。元の文章がない状態から、§1の設計(読者・主メッセージ・スケルトン・濃淡・素材集め)→§2の執筆→検査→収束の全工程で書き起こす。素材が乏しければ§1-4で先に集めるか、ユーザーに求める/natural-japanese score [quick|full|exp] <ファイル> — 診断のみ。文書を書き換えず、自然度スコア(0〜100、高いほど自然=AI臭が薄い)と理由で返す。quick=lint のみ(30秒)、full=構造・読みやすさレビュー込み、exp=semantic.py の深層検出込み(初回約1GBダウンロード)。最初に必ず references/diagnose.md を読む。スコアの算出式・バンド・出力形式の定義がそこにあり、これを読まずに lint findings の転記で返した時点で診断モードの仕事になっていない。診断後にリライトを提案してよいが、頼まれるまで直さないモード指定がなければ実行モードの基準で自分で選ぶ。自然言語でも同じ(「〇〇について書いて」→ write 相当、「この文章AIっぽい?」「AI臭さを採点して」→ score 相当)。
誰が読み、読んだ後に何が起きてほしい文書かを特定する(不明ならユーザーに聞く)。文書タイプが定まったら、対応する型を読む:
references/doctypes/minutes.mdreferences/doctypes/report.mdreferences/doctypes/guide.mdreferences/doctypes/memo.mdreferences/doctypes/slide.md型に当てはまらない文書(note・ブログ・エッセイ等)はこの節を飛ばしてよい。
本文を書く前に、主メッセージを一文で書く。書けないなら素材不足であり、書き方の問題ではない(→ 1-4)。次に見出しスケルトンを作る。各見出しは「背景」「まとめ」のようなラベルではなく、結論を含むメッセージにする。見出しだけを順に読んで論旨が通ることを確認してから本文に進む。
すべての節を同じ熱量・同じ厚みで書くと、それ自体が「整いすぎた不自然さ」になる。重要な節を厚く、軽い節は正直に軽く、と意図的なムラを設計しておく。手順は references/revision-guide.md の「濃淡設計」を参照。
固有名詞・数値・実例が手元に乏しいまま書き始めると、後段で「一般論しか言えていない」と気づいても直しようがない。推論と検索の往復で素材を集める手順、十分と判断する基準、Web検索不可の環境でのユーザーへの素材提供依頼は references/revision-guide.md の「素材集め」を参照。
style-profile.md(プロジェクトルートかユーザー指定の場所)が既にあれば読み込み、視点・語彙・リズムの癖を下敷きにする。なければ汎用モードで進めてよい。ユーザーが「自分の文体を学ばせたい」と求めた場合のみ、assets/style-profile-template.md に沿って過去文章3〜5本から特徴を抽出し、プロファイルを書き出す(断定しすぎず「傾向として」と留保をつける)。ユーザーが具体的な語や組み合わせを「自分は使わない」「不自然」と明示した場合は、一般規則へ拡張せず、出典と適用範囲を添えて同プロファイルの「避ける表現」へ記録する。単語全体を禁止せず、指摘された組み合わせを最小単位にする。
references/writing-constitution.md の12箇条を制約として本文を書く。要点だけ挙げると——結論から書き前置きを書かない、見出しはメッセージ、説明は地の文で書き箇条書きは真に並列な圧縮のみ、専門用語は「機能→名前」の順で文中説明、固有名詞・数値で接地、太字は文中の核1箇所、濃淡をつける、同じ鋳型を3回繰り返さない、「〜ではなく」は本当の誤解訂正だけ、限界と推定は明示ラベルで開示、事実と意見を分ける、結びは再統合しレポートは So What まで。
この段階では禁止語やリズムを気にしすぎず、憲法の範囲で内容を出し切ってよい。細部は次の検査工程が拾う。
uv run scripts/lint.py --json <file>禁止語・翻訳調・否定肯定対比の反復・文長の均質さ・体言止め率・段落頭の接続詞率・語彙多様性・英語統語の疑いなどを機械的に検出する。検出結果は件数に関わらず exit code 0(lint なので、件数で CI を止めることはしない)。入力エラーのときだけ exit code 1。
対象文書のジャンルが明確なら --genre essay|tech|business を指定する。コーパス校正済みの閾値プロファイルに切り替わり、誤検知が減る。ジャンルごとの判断基準の差分は references/genre-notes.md を参照。
収束ループ(4〜5)では、直前の --json 出力を --baseline に渡すと resolved / new / persisting を自動で仕分けてくれる。uv が使えない環境(Claude.ai 等)では references/manual-checklist.md で同じ観点を人手でなぞる。
もう一つ、scripts/semantic.py という EXPERIMENTAL な意味的検出器がある。文埋め込みで隣接文の類似度の起伏(話題の平板さ)を測るもので、torch + sentence-transformers 依存・初回~1GBのモデルダウンロードを伴う重量級のため lint.py 本体には組み込まず、独立した opt-in エントリにしている。フル工程や環境が許すときだけ uv run scripts/semantic.py --json <file> を追加で回し、findings は lint と同じく判断台帳に載せて扱う。
lint の findings は疑いの提示であり、機械的に全部直せという指示ではない。今回ヒットしたカテゴリの節を references/revision-guide.md で読み直し、文脈に照らして「直す/直さない」を判断する。判断は finding 一つひとつに「直した」か「残す(理由)」かを書き残しながら進める(台帳の形式は同ファイルの「判断台帳」を参照)。
用語カタログが必要なら: 禁止語 → references/forbidden-patterns.md、翻訳調 → references/translationese.md。専門用語が初出で説明されているか確認する材料には uv run scripts/terms.py <file> を使う。カタカナ複合語・ASCII略語・固有名詞らしき語を初出行・出現回数・説明マーカーの有無つきで列挙する(説明済みかどうかは機械が判断せず、AI/人間が行う)。
lint は文レベルの表層しか見えない。特に箇条書き主体の議事録・スライドでは lint がほぼ素通りするため、構造レビューが主役になる。完成した本文から見出しと各段落の先頭文だけを抜き出して読み、次を確かめる(uv run scripts/outline.py <file> で見出し・各段落の先頭文・箇条書きプレースホルダを行番号付きで機械抽出できる):
文書タイプが定まっている場合は、doctype の「必須要素」と「AIがやりがちな失敗」も照合する。
読解負荷の高い箇所は uv run skills/natural-japanese/scripts/lint.py --reading-load <ファイル> で指さしを出せる(一文長・埋もれた列挙・連続漢字・二重否定・「の」連鎖)。これは AI臭さの検出とは別目的の推敲用レーンで、自然度スコアにも --baseline 比較にも入らない。出力は「この文を見ろ」であって「直せ」ではない。指摘は起点として扱い、どう直すかは下記カタログの該当項目で判断する。
語順、読点の位置、一文一義、主語述語の距離、こそあど言葉の多用、冗長表現は、機械的な閾値化ができないと実証済みの判断領域。references/readability-principles.md(一般原則)と references/readability-antipatterns.md(悪文パターン27種を読解負荷順に A→J で分類したカタログ)を参照しながら毎周回、目視で判断する。カタログは前から当てる——A(否定の入れ子)・B(係り受けの距離)・C(語と語形の重さ)が一文の中で読者に計算を強いる高負荷層で、H・I・J は文書・表記・読者の知識にまたがる層。短さは目的関数にせず、事実保持と主述・係り受けを確認した後の同等候補間でだけタイブレーカーに使う。文の分割や列挙の展開で字数が増えるのは正しい結果であり、不合格の理由にしない。
構造レビュー・読みやすさレビューで見つけた問題も、lint の finding と同様に判断台帳へ一行として起こす。
段落が一般論しか言えていない(固有名・数値・実例がない)場合は、書き方でなく素材の問題であることが多い。references/revision-guide.md の「素材不足の分岐」を見て情報収集に戻るべきか判断する。
台帳の「直した」項目を反映したら lint を再実行し、新しい finding が出ていないか確認する。台帳上の全 finding が仕分けられ、修正が新たな finding を生んでいない状態になるまで 3〜4 を繰り返す。同じ finding が2周連続で再発する場合は references/revision-guide.md の「発散ガード」を参照。
既存文書のリライトでは、同じ種類の修正(見出しの結論化、箇条書きの地の文化など)を全項目へ一律に当てると、元の文書の自然な濃淡を消してかえってAI臭が増す。価値を足せる箇所だけを選んで直す原則は references/revision-guide.md の「改稿を一律に適用しない」を参照。
lint と台帳が収束しても、それは既知の表層パターンが消えたことしか意味しない。ここから先には、lint では拾えない「無菌室のような冷たさ」「ダラダラとした冗長な引き伸ばし」が残りやすい。
フルモード(および重要な文書)では、references/eval-rubric.md の 6軸推敲ルーブリック を用いて客観評価を行う。
合格基準は全軸90点以上・総合平均92点以上。未達の軸があればボトルネックを特定して改稿し、合格に達するまでループを回す(手順詳細は references/eval-rubric.md および references/revision-guide.md を参照)。クイックモードではこの6観点を頭の中で通読点検して終える。違和感を見つけたら直して完了とする。
完了したら、作業中に作った中間ファイル(台帳・lint の JSON・下書きのバックアップ等)をすべて削除する。ユーザーのプロジェクトに残してよいのは完成した文書と、ユーザーが明示的に望んだ場合の style-profile.md だけ。詳細は references/revision-guide.md の「作業ファイルの扱い」を参照。
before/after の具体例は references/examples.md を参照。
© coji, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 27 other files (scripts, references, assets) in skills/natural-japanese of coji/natural-japanese.
Open the folder on GitHubat commit 9a78a42
Natural Japanese Business Writing 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Natural Japanese Business Writing this skillcoji/natural-japanese | 1.9k | — | ~2.1k | Automated safety check: Pass | MIT | |
| Chinese Technical Writingleter/zh-tech-writing | 352 | — | ~656 | Automated safety check: Pass | MIT | |
| Declaudingoaustegard/claude-skills | 150 | — | ~5.2k | Automated safety check: Pass | MIT | |
| User-Facing Text Cleanupguillaumemeyer/watermarks-remover | 24k | — | ~3.5k | Automated safety check: Pass | MIT | |
| Chinese Text Humanizerop7418/Humanizer-zh | 19k | — | ~2k | Automated safety check: Pass | MIT | |
| Defensive Writing Editorlennney/stop-that-shit | 2.5k | 1 repos | ~1.2k | Automated safety check: Pass | MIT |
leter/zh-tech-writing
Sets writing rules for Chinese technical docs: short plain sentences, consistent typography and a checklist for removing AI-sounding filler.
oaustegard/claude-skills
Rewrites model-sounding prose into plain technical writing and checks that every claim survives, for PR text, docs, commit messages and similar drafts.
guillaumemeyer/watermarks-remover
Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.
op7418/Humanizer-zh
Edits Chinese articles, comments and documents to remove filler, repetition and template phrasing while keeping the facts, the level of certainty and the author's voice.
lennney/stop-that-shit
Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.
iflytek/skillhub
Audits and rewrites formulaic, AI-sounding prose while keeping facts, voice and format, using a local Python scorer and inspect-only, rewrite or embedded-gate modes.
Categories
Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads. The skill targets everyday Japanese work documents: minutes, including ones built from a transcript, research and analysis reports, internal guides, memos, proposals, emails and slide outlines, as well as note articles, blog posts and essays. Its design rests on two ideas: a machine detects suspect phrasing while the agent decides what to change, and preventing awkward text through design and constraints before writing beats cleaning it up afterward.
Natural Japanese Business Writing fits situations like: turning a meeting transcript into Japanese minutes; rewriting stiff or machine-sounding Japanese so it reads naturally; scoring how AI-like a Japanese document sounds without rewriting it; drafting a Japanese report, proposal or internal guide from scratch.
Run `npx skills add coji/natural-japanese --skill natural-japanese -a claude-code`. Or copy the skill folder (skills/natural-japanese in coji/natural-japanese) into .claude/skills/natural-japanese in your project. Claude Code loads it when a task matches its description.
Run `npx skills add coji/natural-japanese --skill natural-japanese -a codex`. Or copy the skill folder (skills/natural-japanese in coji/natural-japanese) into .agents/skills/natural-japanese in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coji/natural-japanese --skill natural-japanese -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/natural-japanese, .gemini/skills/natural-japanese, .github/skills/natural-japanese and .opencode/skills/natural-japanese in your project.
Going by SKILL.md and its folder, Natural Japanese Business Writing needs the command-line tools its instructions call (uv). Our summary lists: Python for the bundled lint and `semantic.py` scripts.
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Natural Japanese Business Writing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 47k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Natural Japanese Business Writing: Chinese Technical Writing (leter/zh-tech-writing, 352 stars), Declauding (oaustegard/claude-skills, 150 stars), User-Facing Text Cleanup (guillaumemeyer/watermarks-remover, 24k stars) and Chinese Text Humanizer (op7418/Humanizer-zh, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
coji (a GitHub user) maintains it in coji/natural-japanese, which has 1,896 GitHub stars. The repository was last updated on September 4, 2026.
Source: coji/natural-japanese on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.