本文へ移動
cccskills
無料GitHub で公開

readable-writing

文章を書くときに使う。ユーザーが既にある文章を渡した場合、AI特有の読みにくさをレビューし、指摘をすべて修正する。Writes and reviews prose for AI writing patterns and rewrites it.

インストール方法を見る

含まれるファイル(26)

  • SKILL.md5.4 KB
  • LICENSE3.1 KB
  • policies/common/agency.md4.8 KB
  • policies/common/document.md12.1 KB
  • policies/common/lists.md7.5 KB
  • policies/common/rhetoric.md9.1 KB
  • policies/common/stance.md6.7 KB
  • policies/common/symbols.md1.2 KB
  • policies/en/agency.md2.1 KB
  • policies/en/document.md1.8 KB
  • policies/en/rhetoric.md2.3 KB
  • policies/en/stance.md3.1 KB
  • policies/en/symbols.md266 B
  • policies/ja/agency.md6.2 KB
  • policies/ja/document.md2.6 KB
  • policies/ja/rhetoric.md6.5 KB
  • policies/ja/stance.md4.2 KB
  • policies/ja/symbols.md288 B
  • policies/ja/vocabulary.md531 B
  • prompts/fields.md440 B
  • prompts/judgement.md632 B
  • README.md3.9 KB
  • scripts/mechanical.pl10.9 KB
  • scripts/review.sh7.1 KB
  • scripts/rules/en.pl4.0 KB
  • scripts/rules/ja.pl6.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Readable Writing

成果物は修正後の文章

自然言語だけを見る

観点とポリシー

ポリシーファイルは policies/ 配下

  • common/
  • ja/
  • en/
観点ファイル見るもの
立場stance.md書き手が引き受ける範囲
主体agency.md行為の主体
箇条書きlists.md箇条書きの階層と粒度
文書構成document.md見出し、節、情報の取捨
修辞rhetoric.md構文の型とリズム
語彙vocabulary.md語の選択
記号symbols.md記号と字面

検出対象

  • 立場
    • 反証できない主張
    • 結論の回避
    • 弱い否定
    • 強度の振り切り
    • 裏を取らない伝聞
    • ヘッジ
    • 儀式化した免責
    • Praising everything
  • 主体
    • false agency
    • 実装判断の壮大化
    • 受動態
    • 自動詞化
    • 遠くから語る話者
    • 一般論だけの段落
    • 翻訳調動詞
    • Missing first person
  • 箇条書き
    • 平坦な箇条書き
    • 1項目への詰め込み
    • 条件と処置の同居
    • 階層の付け間違い
    • 段落に流した並列
  • 文書構成
    • 命題型の見出し
    • 見出しから導ける本文
    • 見出しと中身のずれ
    • しないことの記述
    • 経緯の記録
    • 例外条項の後付け
    • メタ的な構造宣言
    • 目的の言えない情報
    • 太字の疑似見出しとスコープ外の節
    • The head of a design document
  • 修辞
    • 二項対比
    • 否定的列挙
    • 劇的な断片化
    • 一文圧縮
    • 3項目並列
    • ムラの欠如
    • 段落の均一な閉じ方
    • pull-quote調
    • 文頭のクセ
    • 余った断定と動作の名詞化
  • 語彙
    • 英語固有名詞の律儀さ
    • scripts/rules/<lang>.pl の語
  • 記号
    • 括弧による後置補足
    • 評価を囲む鉤括弧
    • Scare quotes

手順

1. 対象の確定

$1 を起点にする

  • ディレクトリの場合
    • Globでファイルを集める
    • 対象をユーザーに確認する
    • ファイルごとにステップ2から繰り返す
  • 会話中の下書きの場合
    • 一時ファイルに書き出す
  • これから書く場合
    • 先に下書きを最後まで書く
    • 一時ファイルに書き出す
  • ユーザーが渡さなかった場合
    • 対象を聞く

2. レビューの実行

bash ~/.claude/skills/readable-writing/scripts/review.sh <ファイルパス>
  • 過去のrunと同じ (category, quote) の指摘
    • 標準出力に含めない

3. 指摘の整理

  • 重複の統合
    • 同じ quote についての指摘は1件にする
  • 修正の並び順
    • 同一ファイル内は行番号の昇順
  • 指摘の採否
    • quote が本文に実在するかだけで決める
    • 書き先の慣例と食い違う指摘も直す
      • コミットメッセージの72桁折り返しより 文中での改行 の指摘を優先する

4. 修正

  • 対象ファイルをReadで開く
    • quote の前後を読む
  • fix が付いている指摘
    • 機械的な指摘にだけ付く
    • 前後の文と繋がるように書き換えてから使う
  • fix のない指摘
    • problem を読む
    • 前後の文に合う形に書き換える
  • 同一段落への修正が複数ある場合
    • 段落ごとにまとめて書き換える
  • 修正の順序
    1. 先に直す
      • 立場
      • 主体
    2. 段落を組み直す
      • 箇条書き
      • 文書構成
      • 修辞
    3. 本文に残っていないか確かめる
      • 語彙
      • 記号
  • 書き換えた文に ## 検出対象 の名前を当てる
    • 当たった名前の節を、その観点のポリシーをReadで開いて読む
    • AI版 と 修正版 の対比から直し方を取る
    • 書き直した文にも名前を当てる
      • 当たった場合
        • その節の直し方で直す
  • 書き換えで足せるもの
    • 修正前の本文にある情報
    • ユーザーが会話で渡した情報
  • 書き換えで足せないもの
    • 留保
    • 免責
    • 未検証であることの断り
    • 読み手が聞いていないことへの先回り
  • 指摘のある箇所のみ書き換える

5. 成果物の提示

  • ファイルが対象の場合
    • Editで書き換える
    • 指摘が0件の場合
      • 「修正なし」と返す
  • 一時ファイルに書き出した場合
    • ユーザーが書き先を指定している場合
      • Writeで置く
    • 指定していない場合
      • 修正後の本文だけを出力する

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use by any agent before writing specs, editing code, or changing workflow files when the change could add compatibility behavior, aliases, silent fallbacks, or default-value fallbacks.

日本語の概要は準備中です。原文の説明を表示しています。

ogadra/dotfiles32026年10月10日 更新

Cascade merge changes through a chain of dependent branches. Use when updating stacked/chained PRs, propagating changes from a parent branch to all downstream branches, or when the user mentions "cascade merge", "propagate changes", "update dependent branches", or "merge to downstream branches".

日本語の概要は準備中です。原文の説明を表示しています。

ogadra/dotfiles32026年10月10日 更新

grill-me

無料

Interview the user in rounds until no branch of the design tree stays open.

日本語の概要は準備中です。原文の説明を表示しています。

ogadra/dotfiles32026年10月10日 更新

import-skill

無料日本語概要

外部のスキルをこのリポジトリにコピーして自分のスキルにする。ユーザーがスキルのURLやリポジトリ名を渡して「入れたい」「導入したい」と言ったとき、「上流を参照せずコピーしたい」と言ったとき、またはユーザーが `/import-skill` と打ったときに使う。Vendors an external Claude skill into this repository.

ogadra/dotfiles32026年10月10日 更新

ponytail

無料

Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has been paged at 3am for a factory class that wrapped one function: question whether the task needs to exist at all, reach for the standard library before custom code, native platform features before dependencies, one line before fifty. Supports intensity levels: lite, full, ultra. The default is full. Use on ANY coding task: writing, adding, refactoring, fixing, reviewing, or designing code, and choosing libraries or dependencies. Also use whenever the user says "ponytail", "be lazy", "lazy mode", "simplest solution", "minimal solution", "yagni", "do less", or "shortest path", or complains about over-engineering, bloat, boilerplate, or unnecessary dependencies. Do NOT use for non-coding requests such as general knowledge, prose, translation, summaries, recipes.

日本語の概要は準備中です。原文の説明を表示しています。

ogadra/dotfiles32026年10月10日 更新

pr-create

無料日本語概要

PRを作る、または既存PRのbodyを直す。ユーザーが「PRを作る」「PR出して」「PRのbodyを直して」と言ったとき、ユーザーが `/pr-create` と打ったとき、または `gh pr create` や `gh pr edit --body` がhookにブロックされたときに使う。Creates or edits a pull request with a three-line body.

ogadra/dotfiles32026年10月10日 更新

ogadra のスキルをすべて見る

このスキルの問題を報告する