Menu
技術文書の品質を向上させます。README、コードコメント、API文書、設計書、 ユーザーガイド、サンプルコードの執筆時に使用します。 Google Technical Writingコースに基づくベストプラクティスを適用します。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
定期的な CLAUDE.md の振り返り改善。過去 N 週間の session transcript から 繰り返し指示・訂正フィードバック・ルール未発火を発掘し、CLAUDE.md 自体の 重複・陳腐化・自己矛盾も洗い出して、承認を得て反映する。 「CLAUDE.md 改善」「CLAUDE.md 振り返り」「claude md retro」 「繰り返し指示の調査」「session 分析」「ルールの棚卸し」「指示の振り返り」 「同じ指示を何度もしている」などで使う。単発 session の学びの反映や単純な 品質監査は claude-md-management plugin の管轄で、複数 session を横断した 発掘を伴うときにこの skill を使う。
現在のセッションの議論・調査・実装内容を自己完結した brief に梱包し、 model: fable の subagent を壁打ち相手として起動する。Fable の回答を 原文で示したうえで main (Opus) の評価を添えて提示する。 「fable に聞いて」「fable に相談」「fable のアドバイスをもらって」 「fable の意見は」「fable に壁打ち」など、Fable を名指しで相談・ レビュー依頼するときに使う。Fable は現在のセッションを見られないため、 第三者モデルの視点・セカンドオピニオンを得たいときに必ずこの skill で 文脈を梱包してから呼び出す。
現在の会話を stock(確定した決定・調査結論・成果物・未解決の論点) と flow(時系列の経緯ログ) に分離し、1 枚の Artifact ダッシュボードとして 可視化する。会話の節目で同じ Artifact を再 publish して最新化し続ける。 「stock flow で可視化」「会話ダッシュボード」「会話の現在地を見せて」 「今どこにいるか俯瞰したい」「stock と flow を分けて」「議論を整理して Artifact に」などで使う。会話が長くなり決定・未決・成果物が経緯に 埋もれてきたとき、全体を俯瞰したいときにも積極的に使う。
タスク完了時にセッション名を自動付与する。 claude -p でのタスク実行終了時、結果に基づいた セッション名をファイルに書き出す。SessionEnd hook が 読み取り jsonl に反映する。タスクが完了した、 作業が終わった、セッション名を付けたい、 最後の仕上げとして使用する。
This skill should be used when the user asks to "make text more human", "humanize this text", "add personality to writing", "make AI text natural", "revise for human touch", "人間らしく", "人間っぽく", "自然な文章に", or when refining AI-generated content to feel less robotic. Use when transforming mechanical AI output into warm, authentic human expression. Also use when the user asks to write in a specific persona's style.
現在のブランチの GitHub PR を cmux のブラウザペインで 右側に表示する。「PR 見せて」「PR 開いて」「PR 表示」 「cmux で PR」「横に PR」で使用。
| name | technical-writing |
| description | 技術文書の品質を向上させます。README、コードコメント、API文書、設計書、 ユーザーガイド、サンプルコードの執筆時に使用します。 Google Technical Writingコースに基づくベストプラクティスを適用します。 |
技術文書を執筆する際の基本原則です。
受動態: A wrapper is generated by the process.
能動態: The process generates a wrapper.
能動態は読者の処理時間を短縮し、行為者を明確にする。
| 避ける | 使う |
|---|---|
| The error occurs when... | Dividing by zero raises the error. |
| There is a variable X | The X variable stores... |
| screamingly fast | 225% faster |
良いドキュメント = 読者が必要な知識 - 読者の現在の知識
技術文書を書く際の確認項目: