skill

japanese-writer

usadamasa/japanese-writercommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/usadamasa/japanese-writer itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 25, 2026

japanese-writer

日本語の技術文書を書く・校正するための Claude Code plugin。

収録内容

入口は 2 つ。書くときは japanese-tech-writing が構成から推敲まで導き、書き上がったら /japanese-writer:proofread で添削する。残りは proofread の内側から呼ばれるか、指摘を受けたときに使う。

ユーザー
├─ /japanese-writer:setup ── 自動の準備が失敗したとき、crit をリンクするとき
├─ 書く ── japanese-tech-writing (Phase 1 構成 → 2 執筆 → 3 推敲)
│             └─ Phase 3 の最後に proofread を呼ぶ
├─ /japanese-writer:proofread ── 添削の入口
│    ├─ textlint-check (機械点検と autofix)
│    └─ proofreader (subagent)
│         ├─ japanese-tech-writing (規範として読む)
│         ├─ sanitize-artifacts (漏出の観点として読む)
│         ├─ style_check で差し込んだ文体 skill (任意)
│         └─ domain_check で差し込んだ用語 skill (任意)
├─ /japanese-writer:writing-feedback ── 言い回しを直されたとき
│    └─ crit の approve 後の prompt (crit/on_finish_approved.md) からも呼ばれる
├─ /japanese-writer:gate-off, gate-on ── このセッションの間だけ Stop hook の点検を止める・戻す
├─ (自動) SessionStart hook: writing-gate を data ディレクトリへビルド ── セッションを開くとき
└─ (自動) Stop hook: writing-gate ── セッションを閉じるとき

種別	名前	役割	呼び方
skill	setup	前提コマンドの確認、writing-gate のビルドと検証のやり直し、crit の prompt リンク	ユーザーが `/japanese-writer:setup` で呼ぶ。SessionStart hook の準備が失敗したとき、未ビルドのまま Stop hook に止められたとき、crit をリンクするとき
skill	japanese-tech-writing	技術文書の構成・論証・段落の規範。書き始める前の構成検討から推敲まで扱う	文書を書くとき Claude が読み込む。`/japanese-writer:japanese-tech-writing` で明示的にも呼べる
skill	proofread	md ドラフトの総合添削。proofreader subagent へ委譲し、修正案が一意なものは適用して報告し、論証に関わるものは警告に留める	ユーザーが `/japanese-writer:proofread` で呼ぶ (添削の入口)
skill	textlint-check	textlint による機械点検と自動修正。呼び出し元が `config_root` で config を切り替える	proofread の内側から呼ばれる。機械点検だけ欲しいときは単体でも呼べる
skill	sanitize-artifacts	対話で仕上げた成果物から、制作過程と却下した案の痕跡を取り除く	proofreader が点検の観点として読み込む。「これは消して」の後の作り直しでは単体で呼ぶ
skill	writing-feedback	言い回しへの指摘を prh のルールとして登録し、次から機械が拾えるようにする	ユーザーが言い回しを直したときに呼ぶ。crit の approve 後の prompt からも回る
skill	gate-off / gate-on	このセッションの間だけ Stop hook の文章点検を止める・戻す。ファイルや設定には触れない	ユーザーが `/japanese-writer:gate-off` と `/japanese-writer:gate-on` で打つ。Claude が Skill ツールで呼んでも効かない
agent	proofreader	proofread skill から呼ばれる添削担当の subagent	proofread が dispatch する。直接は呼ばない
hook	SessionStart: prepare	writing-gate のビルドの入力が前回と違えば data ディレクトリへビルドし直し、crit の prompt を data へ複製する	自動 (開始時)
hook	Stop: writing-gate	セッションを閉じるときに、編集した `.md` を点検して重大な指摘があれば完了を止める	自動 (完了時)
crit prompt	`crit/on_finish_approved.md`	crit のレビューが approve されたとき、言い回しへの指摘を writing-feedback へ回す	crit が approve 時に読む

writing-gate は文書全体の集計 (語尾の連続・文体の混在) と逐語の漏出を見る Go 製の CLI。設計とルールの置き場は writing-gate/README.md にある。

前提

Node.js (npx)。textlint は npx で都度取得するので、node_modules を用意する必要はない
jq
Go (writing-gate のビルドに使う)。PATH の go が go.mod の toolchain 行 (go1.26.10) より古いと、 GOTOOLCHAIN が既定の auto なら go がその版を取得してビルドするので、初回はネットワークが要る

インストール

配布は marketplace usadamasa (usadamasa/agents-marketplace) 経由で行う。Claude Code で次を実行する。

/plugin marketplace add usadamasa/agents-marketplace
/plugin install japanese-writer@usadamasa

セットアップ

install の後に手で打つものは無い。セッションを開くと SessionStart hook が、Stop hook の起動する writing-gate を plugin の data ディレクトリ (~/.claude/plugins/data/japanese-writer-usadamasa/bin/) へビルドし、既知の漏出パターンを拾えることまで検証する。初回は Go のビルドの分だけ開始が遅れる。

install 先 (~/.claude/plugins/cache/usadamasa/japanese-writer/<version>/) は版ごとに変わるが、 data ディレクトリは update をまたいで残る。hook はビルドの入力 (Go のソースと埋め込みルール) の cksum を前回と比べ、変わったときだけビルドし直す。update の後に再ビルドやリンクの張り直しは要らない。

準備に失敗すると、開始時にその理由が表示される。ビルドできていないあいだは、Stop hook が完了を止めて /japanese-writer:setup を案内する。setup は前提コマンドを確かめてからビルドをやり直し、失敗の理由を返す。

/japanese-writer:setup

crit との連動 (任意)

crit を使っているなら、approve 後の prompt を plugin のファイルへリンクする。crit が PATH にあると setup がこれを提案する。リンク先は data ディレクトリの複製 (~/.claude/plugins/data/japanese-writer-usadamasa/crit/on_finish_approved.md) で、中身は SessionStart hook が新しい版に揃えるので、張るのは 1 回で済む。

以前の setup が張った、版ごとの置き場を指すリンクは --crit で data の複製へ張り替える。指し先が消えたリンクも張り替え、それ以外の場所を指しているときは触らずに報告だけする。

文体とドメイン用語の差し込み

proofread は汎用の機械点検と文章規範だけを持つ。書き手ごとの文体とドメイン固有の用語は、ユーザー側の ~/.claude/skills/ に置いた skill を引数で名指しして差し込む。

引数	差し込むもの	例
`style_check`	書き手の文体 (文書の種類ごとの語尾・句読点・絵文字の指紋) を持つ skill	`{"skill": "my-writing-style"}`
`domain_check`	用語表や事実の正本を持つ skill と、検出結果の Tier 分類表	`{"skill": "my-domain-terms", "tiering_ref": "references/tiering.md"}`

tiering_ref は絶対パスか、~/.claude/skills/<skill>/ からの相対パスで指定する。どちらも省略でき、省略した側の点検は skip され、結果の skipped に記録される。

注意点

同梱の textlint config は、半角の句読点「。、」を全角の「。、」へ autofix する。コード (インラインとブロック) の中は書き換えない。

開発

plugin を使うだけなら「前提」節のツールで足りる。このリポジトリで開発するときは、加えて次を用意する。

flakes を有効にした Nix。Go・task・golangci-lint・shellcheck・bats・jq・ jv は flake.nix の devShell で揃え、版は flake.lock が固定する nixpkgs で決まる。nixpkgs に無い jv は flake.nix の中でソースからビルドする。CI も同じ flake を使う
direnv と nix-direnv。.envrc が use flake で devShell を読み込むので direnv allow する
Claude Code CLI (task validate が claude plugin validate を呼ぶ)

go.mod の go ディレクティブは devShell の go_1_26 と揃え、GOTOOLCHAIN=local でずれたら失敗させる。 toolchain 行は利用者の手元で SessionStart hook がビルドするときの下限で、 GOTOOLCHAIN=local の devShell と CI では効かない。ツールの版を上げるときは nix flake update で flake.lock を更新する。 Go は nixpkgs の版が修正版に届かない間、flake.nix の devGo がソースを差し替える。

CI と同じ確認は task で手元でも通せる。

コマンド	内容
`task build`	`bin/writing-gate` をビルドする
`task test`	ビルドしてから Go のテストと bats を実行する
`task lint`	golangci-lint と shellcheck を実行する
`task validate`	`claude plugin validate --strict` と、JSON / YAML が宣言した schema での検証を実行する

謝辞

参考にした・翻案した skill・gist・書籍の一覧は ACKNOWLEDGMENTS.md にある。

ライセンス

MIT