Natural Writing Ja
Japanese prose norm for writing explanatory text that does not read as machine-generated. Built on one diagnostic axis (does a sentence update the situation or the document?) plus register purity, sentence-beat and 体言止め/反問 rules calibrated against 937 sentences of human technical writing. Use when drafting or revising Japanese articles, docs, or long-form explanations, especially after an LLM produced the draft. For English use natural-writing-en; for scoring a draft use ai-index.
Install
npx skills add mizchi/skills --skill natural-writing-jagit clone --depth 1 https://github.com/mizchi/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/natural-writing-ja ~/.claude/skills/natural-writing-jaPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Natural Writing — Japanese Writing Japanese explanatory prose that reads as written by someone, about something they did. The norm has one axis, and most of what makes machine prose recognisable falls out of it. Everything else here is calibration: measured ranges from a corpus of human technical writing, so the rules have numbers instead of taste. Sources: the diagnostic axis and the beat/tension design are [k16shikano's cognitive-rhythm-writing norm](https://gist.github.com/k16shikano/eb2929f13ed19c97188393d297be8432). The measured ranges are from 18 mizchi Zenn articles, 937 prose sentences (`ai-index/references/calibration.md`). ## The axis **Does this sentence update the situation, or update the document?** | | what it reports | keep? | | --- | --- | --- | | 状況を更新する | an event, a number, a measurement, something someone said; or the writer's own judgement state — a belief held, a doubt, a concession, a regret | yes, including as deliberate slack | | 文書を更新する | how this text looks, what it will cover, what was covered above, how to read it | delete | Document-updating sentences carry no information about the subject. They are what fluent-but-empty prose is made of, and they are the first thing to cut. ``` ✗ 本章では A、B、C について解説します。 ✗ ここまでは概念の説明でした。次は具体例を見ていきます。 ✗ 要するに、この章の主題は X ではなく Y です。 ✗ テクニックの列挙はしません。 ✓ この三つの性質は、どれも冒頭の失敗の中にそろっている。 ✓ まあ、今すぐ手を打つほどでもないのだけど、どこかの時点で整理は要るだろう。 ✓ うまくいっているに違いない。 ← 思い込み。あとで事実に崩される布石 ``` Two traps:
Details
- Skill name
natural-writing-ja- Repository
- mizchi/skills
- Path
natural-writing-ja/SKILL.md- Repo updated
- 18 November 2026
FAQ
What does the Natural Writing Ja skill do?
Japanese prose norm for writing explanatory text that does not read as machine-generated. Built on one diagnostic axis (does a sentence update the situation or the document?) plus register purity, sentence-beat and 体言止め/反問 rules calibrated against 937 sentences of human technical writing. Use when drafting or revising Japanese articles, docs, or long-form explanations, especially after an LLM produced the draft. For English use natural-writing-en; for scoring a draft use ai-index.
How do I install the Natural Writing Ja skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add mizchi/skills --skill natural-writing-ja. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Natural Writing Ja popular?
It lives in mizchi/skills, which has 423 GitHub stars and 6 forks.
Related skills
Actions CI Tuning
423mizchi/skills
Use when auditing or improving GitHub Actions workflows for a project. Covers cache setup (npm/pnpm/yarn), job parallelism, shard-based test splitting, artifact handling pitfalls, and Playwright-specific patterns. Trigger on: slow CI, cache miss, flaky shard jobs, merge-reports failures, or an explicit 'tune CI' request.
AI Index
423mizchi/skills
Method and tooling for measuring how AI-generated a piece of prose reads, in Japanese or English. Two layers — a deterministic lint for removable surface tells (scripts/slopscore.py, no API) and a judgment layer of typed probabilistic questions (Jev noul/score) for the tells that survive editing. Includes measured human/AI baselines, a gap-first calibration procedure, and labeled fixtures. Use when building or calibrating an AI-likeness score, or when a draft needs a defensible number rather than a vibe. For writing guidance use natural-writing-ja / natural-writing-en instead.
Apm Usage
423mizchi/skills
Reference for APM manifests, installation, targeted updates, deployment paths and lockfiles. Invoke when the user explicitly asks about APM or apm.yml, or an unfamiliar APM command/error needs exact CLI details. Do not automatically invoke for every project that happens to have installed skills.
Tech Article Reproducibility
423mizchi/skills
Evaluate the reproducibility of technical articles. Dispatch a subagent to simulate a first-time reader reproducing the work locally and list missing information. Use as the final check on a draft before publication or to recheck a published article before responding to reader feedback.
Natural Writing En
423mizchi/skills
English prose norm for writing explanatory text that does not read as machine-generated. One diagnostic axis (does a sentence update the situation or the document?) plus measured thresholds for burstiness, hedging, enumeration and paragraph openings, with corrections to widely-cited signals that false-positive on human technical writing. Use when drafting or revising English articles, docs, READMEs or long-form explanations, especially after an LLM produced the draft. For Japanese use natural-writing-ja; for scoring a draft use ai-index.
Imprint
104ilang-ai/Imprint
Your habits, imprinted on AI. Learns how you work from conversation, builds a portable profile, and applies judgment that adapts to you: when to act, when to check with you, when to follow the project's rules over your own defaults. Use this skill whenever the user starts a new session, opens a project, writes or reviews code, debugs, plans, or writes commits. If .dna.md does not exist yet, start the onboarding conversation before doing anything else. Active in almost every working session.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.