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月19日 更新
免费在 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（原文）
安装前可以查看交给 AI 代理的指令内容。
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桁折り返しより
文中での改行の指摘を優先する
- コミットメッセージの72桁折り返しより
4. 修正
- 対象ファイルをReadで開く
quoteの前後を読む
fixが付いている指摘- 機械的な指摘にだけ付く
- 前後の文と繋がるように書き換えてから使う
fixのない指摘problemを読む- 前後の文に合う形に書き換える
- 同一段落への修正が複数ある場合
- 段落ごとにまとめて書き換える
- 修正の順序
- 先に直す
- 立場
- 主体
- 段落を組み直す
- 箇条書き
- 文書構成
- 修辞
- 本文に残っていないか確かめる
- 語彙
- 記号
- 先に直す
- 書き換えた文に
## 検出対象の名前を当てる- 当たった名前の節を、その観点のポリシーをReadで開いて読む
AI版と修正版の対比から直し方を取る- 書き直した文にも名前を当てる
- 当たった場合
- その節の直し方で直す
- 当たった場合
- 書き換えで足せるもの
- 修正前の本文にある情報
- ユーザーが会話で渡した情報
- 書き換えで足せないもの
- 留保
- 免責
- 未検証であることの断り
- 読み手が聞いていないことへの先回り
- 指摘のある箇所のみ書き換える
5. 成果物の提示
- ファイルが対象の場合
- Editで書き換える
- 指摘が0件の場合
- 「修正なし」と返す
- 一時ファイルに書き出した場合
- ユーザーが書き先を指定している場合
- Writeで置く
- 指定していない場合
- 修正後の本文だけを出力する
- ユーザーが書き先を指定している場合
评价
还没有评价。欢迎分享你的使用感受。
评论
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
同一仓库的技能
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月19日 更新
grill-me
免费Interview the user in rounds until no branch of the design tree stays open.
中文简介正在准备中。当前显示原文说明。
ogadra/dotfiles32026年10月19日 更新
外部のスキルをこのリポジトリにコピーして自分のスキルにする。ユーザーがスキルのURLやリポジトリ名を渡して「入れたい」「導入したい」と言ったとき、「上流を参照せずコピーしたい」と言ったとき、またはユーザーが `/import-skill` と打ったときに使う。Vendors an external Claude skill into this repository.
中文简介正在准备中。当前显示原文说明。
ogadra/dotfiles32026年10月19日 更新
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月19日 更新
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月19日 更新