natural-japanese
A skill for writing and editing business Japanese: clear structure, readability and removing machine-text tells
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Reads and rewrites document files
- Runs check scripts through uv
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/natural-japaneseDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .claude/skills
cp -R "$tmp/skills/natural-japanese" .claude/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .github/skills
cp -R "$tmp/skills/natural-japanese" .github/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .devin/skills
cp -R "$tmp/skills/natural-japanese" .devin/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .cline/skills
cp -R "$tmp/skills/natural-japanese" .cline/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .roo/skills
cp -R "$tmp/skills/natural-japanese" .roo/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add coji/natural-japanese --skill natural-japanese -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 9a78a42
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/coji/natural-japanese.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/natural-japanese/
git -C "$tmp" checkout 9a78a42964096da509b8f3e011f0085a5f080151
mkdir -p .agents/skills
cp -R "$tmp/skills/natural-japanese" .agents/skills/natural-japaneseCommands for macOS and Linux, on Windows run them in Git Bash.
Install the skill with npx skills add coji/natural-japanese. For Cursor, ChatGPT and Codex use npx openskills install coji/natural-japanese followed by npx openskills sync.
Other ways from the author
npx skills add coji/natural-japaneseThe main way to install the skill.
This is third-party code. Review the repository files before installing.
What it does
The skill helps the agent write and edit work documents in Japanese: meeting minutes, reports, internal guides, notes, emails and plans. It builds text conclusion-first and watches readability: word order, sentence length, one idea per sentence, punctuation placement. It also removes machine-translation and AI-style tells, with a detector flagging suspicious spots mechanically while the agent decides in context whether to fix or keep them. It has quick and full modes plus a scoring mode that does not rewrite.
Who it is for. For anyone who writes and edits business documents in Japanese.
Good fit when
- You need to write or polish a work document in Japanese
- You need to strip machine-translation and AI-style tells
- You need to score readability without rewriting
Not a fit when
- The text is not in Japanese
- You only need Markdown formatting rather than style work
Example request
Polish this Japanese meeting minutes and remove the machine-text feelLimitations
The skill targets Japanese and does not fit other languages. Some check scripts require uv installed. The full mode takes noticeably longer on long documents.
How to disable. Remove the natural-japanese skill from the agent's skills directory or disable the plugin via /plugin.
Security check
- Reads and rewrites document files
- Runs check scripts through uv
README in short
The README describes a business-Japanese skill installed via npx skills add, or via openskills for Cursor, ChatGPT and Codex, with a /plugin option too. It rests on two principles: the detector flags suspicious spots mechanically while the agent edits, and prevention while writing beats cleanup afterward. The skill runs in quick and full modes, and check scripts run through uv. MIT licensed.
SKILL.md
--- name: natural-japanese description: 仕事の日本語文書を読みやすくわかりやすく書く・直すためのスキル。議事録、調査レポート・分析レポート、社内ガイド・マニュアル、リサーチメモ・企画書・提案書・報告書・メール、スライド構成案といったビジネス文書の作成・校正に使用する。AI臭さの除去、読みにくい・わかりにくい文章の改善、note記事やブログ記事の新規執筆、AI臭さの診断・採点にも対応する。 license: MIT argument-hint: "[write|score] [quick|full|exp] [対象ファイルや依頼内容]" --- # natural-japanese 仕事の日本語を、読みやすくわかりやすく書くためのスキル。
FAQ
How do quick and full modes differ?
Quick handles everyday documents in place; full adds parallel structure and readability reviews for high-stakes text.
Can it only score text?
Yes, the score mode gives diagnostics without rewriting.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand