zenn-practical-writinglisted
Install: claude install-skill shimo4228/zenn-content
# zenn-practical-writing — Zenn/Dev.to 記事の実用軸
**この記事で守ること**: 読者が記事を開いて数秒で「これは何で、読めば自分に何ができるようになるか」がわかり、そのまま手を動かして再現できる。理解に認知リソースを使わせない。
これが Zenn/Dev.to チャンネルの既定の声。essay(思索・意見)や paper(論文)は別チャンネルに独自の声があり、それらとは意図的に文体を分ける。
---
## Scope — いつ使うか
| 書くもの | 使うもの |
|---|---|
| **Zenn/Dev.to の記事**(tech / idea 問わず全て) | **このスキル(既定)** |
| 学術 paper / preprint | `paper-ecosystem` skill |
| genuine な思索エッセイ(だ/である × 発見調) | essay corpus(Substack)へ。`writing-ecosystem` skill |
**Zenn/Dev.to は type(tech/idea)で声を分けない** — すべて実用軸(ですます・即実用)。Zenn frontmatter の `type` は platform 要件として残るが voice は分岐しない。毒humor/刃牙 の personality は話題が合えば任意で足せる([zenn-idea-voice](../zenn-idea-voice/SKILL.md))。
判定: Zenn/Dev.to に出すなら実用軸(このスキル)。だ/である で思索を綴る genuine エッセイは Substack corpus(別 channel)へ。
---
## 継承と上書き(writing-ecosystem との関係)
genre 中立の canon は `writing-ecosystem` skill を正本として **defer**(再掲しない)。essay 固有の Voice だけ **override** する。
| writing-ecosystem の資産 | このスキルでの扱い |
|---|---|
| AI-slop 禁止リスト(日英) | **継承**(defer。実用記事でも誇張語は使わない) |
| タイトルの誠実さ・煽り禁止 | **継承**(defer) |
| ネタ選定 3 軸(検索需要 / 競合 / 一次情報) | **継承**(defer) |
| 自リポ言及の節度(本文 self-link は導線 or 一次資料のみ・同一 repo 1 回まで) | **継承**(defer。クレジット型リンクは関連リンク節へ寄せる) |
| Voice(発見調・結論の問い化・断定→弱化・初期経典の語り口) | **上書き**(実用軸では使わない。ですます調 × 直接指示。下記「文体」参照) |
| Section Length(1 節が全体の 30% を超えない) | 継承 |
---
## 実用軸の 5 ルール
ユーザーの 5 マーカーを、検証可能な具体ルールに落とす。
| マーカー | 具体ルール |
|---|---|
| **情報密度を抑えめ** | 1 節 1 論点。前置き・throat-clearing を削る。短段落。密な散文より箇条書き/表。読者に再読を要求しない |
| **図や実コード** | 1 記事に図/表を **≥1**。コードは