japanese-writing
Skill1 starsChanged 50 days agoMITView on GitHub
Write clear, natural Japanese for long-form writing, pull requests, review comments, and plans by structuring information into readable cognitive units, using precise sentence structure, minimal punctuation, meaningful spacing, and natural rhythm for screen reading.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- philtzjp/skillstheir own version, first seen Oct 28, 2026
- ymatsukawa/skillstheir own version, first seen Jun 2, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- philtzjp/skills★ 2same name
- ymatsukawa/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- accessing-microsoft-learn-docsSkill
- architecture-validatorSkill
- autonomous-researcherSkill
- clean-up-stale-inline-review-notesSkill
- create-artifactsSkill
- create-worktreeSkill
- github-check-pr-review-comments-graphqlSkill
- github-create-draft-prSkill
- github-creating-issuesSkill
- github-replying-to-pr-threadsSkill
- github-sub-issue-creatorSkill
- gitlab-check-mr-review-commentsSkill
- gitlab-create-issueSkill
- gitlab-create-mrSkill
- gitlab-reply-mr-threadsSkill
- gitlab-sub-issue-linkerSkill
- hypothesis-driven-planningSkill
- load-inline-review-notesSkill
- operating-gitSkill
- operating-jetbrains-projectsSkill
- referencing-commit-conventionSkill
- rust-coding-conventionsSkill
- sequential-thinkingSkill
- web-artifacts-builderSkill
The file
Files
設計思想
文章とは、情報を書く技術ではない。
読者の認知を設計する技術である。
良い文章とは情報量が多い文章ではない。
読者が迷わず理解できる文章である。
日本語では、文法的な正しさだけでは読みやすさは生まれない。
一文の構造。 意味のまとまり。 画面上での配置。
これらが揃って初めて読みやすさになる。
文章を書くときは常に、
「何を書きたいか」
ではなく、
「読者はどう理解するか」
を基準に判断する。
基本原則
読みやすさを情報量より優先する。
初稿で完成を目指さない。
まず読みやすい文章を書く。
不足は推敲や対話で補う。
一度にすべて説明しようとしない。
一文
一文には一つの認知単位を書く
一文が長いことは問題ではない。
問題なのは、一文に複数の認知単位が存在することである。
例えば、
- 理由
- 補足
- 例外
- 結論
これらを一文へ同時に入れない。
一文を書き終えたら確認する。
この文で読者に理解してほしいことは一つか。
複数あるなら分割する。
一度で理解できる構造を書く
係り受けを解析しなければ理解できない文章を書かない。
修飾語は修飾対象の近くへ置く。
一度読めば構造が理解できる文章を書く。
読点
読点は最小限とする。
使用目的は次の場合だけ。
- 誤読を防ぐ
- 強調する
- 演出する
理由のない読点は使わない。
特に、
「〜は、」 「〜では、」
のような慣習的な読点は避ける。
読点が増える場合は、
まず文を分割できないか考える。
意味の塊
文章は段落ではなく、
意味の塊で構成する。
一つの意味の塊では一つの話だけを扱う。
意味が切り替われば空行を入れる。
空行は段落ではない。
読者の認知を一度リセットするための視覚的な区切りである。
画面設計
文章は紙ではなく、
画面で読むことを前提に設計する。
画面が文字で埋まる状態を避ける。
長い段落を書くより、
意味の塊を積み重ねる。
視線が自然に流れる配置を意識する。
認知リズム
文章のリズムとは、
文の長さではない。
読者が一度で理解できる認知単位の大きさである。
意味が完結したら文を終える。
意味が一区切り付いたら空行を検討する。
文を切る理由は文字数ではない。
認知が一区切り付いたから切る。
情報量
必要最小限から書く。
詳細は必要になった時点で補足する。
同じ内容を言い換えて繰り返さない。
説明不足を恐れすぎない。
情報過多のほうが認知負荷は大きい。
推敲
文章は生成より推敲で完成する。
書き終えたら、
必ず読者として読み返す。
確認する項目は次の通り。
- 一文に認知単位は一つか。
- 読点に理由はあるか。
- 空行を入れると理解しやすくならないか。
- 一度読めば構造を理解できるか。
- 画面全体が詰まって見えないか。
文章を書いた本人ではなく、
初めて読む読者として確認する。
優先順位
迷ったら次の順序で判断する。
- 読者が理解できるか。
- 一文の認知単位は適切か。
- 意味の塊は自然か。
- 画面は読みやすいか。
- 情報は十分か。
- 表現は美しいか。
情報量より認知負荷を優先する。
美しい文章より理解できる文章を優先する。
本質
このスキルの目的は、
AIらしさを消すことではない。
読者の認知負荷を最小化することである。
その結果として、
AIらしい文章構造は自然に消える。
読みやすい文章とは、
人間らしい文章ではない。
読者が迷わず理解できる文章である。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

