本文へ移動
cccskills
無料GitHub で公開日本語紹介

improve-writing

ブログやエッセイの文章から、同じ結論の繰り返しや整いすぎた言い回しを見直し、書き手の具体的な記憶、意見、余談を生かして自然な語り口に整えるスキル。

原文原文の説明を見る

use when the user complains that prose writing is bad - do not use for code

実行スコア 未検証

インストール方法を見る

こんなときに便利

  • AIらしい文章を見直したいとき
  • 推敲で書き手の個性を残したいとき
  • 結論の重複や曖昧な表現の整理
  • 具体的な記憶や意見を生かす編集

日本語での紹介

できること

文章の内容は伝わるのに書き手の人柄が見えないとき、語り口を見直すための編集指針を提供します。直前の結論を言い直す一文、整いすぎた対句、具体性のない表現を減らし、本人の記憶や立場が伝わる言葉を残します。論旨に直接関係しない余談や控えめなユーモアも、機械的に削らず検討します。

こんなときに便利

ブログやエッセイを推敲した結果、文章が均一でよそよそしくなった場面に向いています。専門家の原稿で、普段使う略記や正確な専門用語が無難な言葉に置き換わってしまったときにも役立ちます。冗談を足すより、書き手が実際に気づいたことや経験したことを生かす方針です。

使い方の例

  • 「この原稿のAIらしい言い回しを見直し、私の余談や具体的な記憶を残して」
  • 「同じ結論を繰り返す文を削り、意見の主語と根拠が伝わる文章に整えて」
  • 「読者が普段使う略記や専門用語を保ったまま推敲して」

注意点

対象はコードではなく文章です。原文の適用場面は、利用者が文章の出来に不満を示したときです。書き手の個性を削りすぎないよう、元の表現を尊重して編集します。

この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル(1)

  • SKILL.md8.3 KB

SKILL.md(原文)

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

What makes the writing feel real (notes from editing WSFF)

  • 2026-07-17 - Dex read this back and handed it over with one note: make the file follow its own rules. Which stings a little, because you can watch me break every one of them in the middle of writing them down. The frontmatter from the last pass even bragged it had killed the summary taps — and left one ("That's the tell.") sitting in the middle of the section that defines summary taps. That one's gone now — and so is one more this pass turned up: a tidy "that instinct is the whole problem in one reflex" riding on the tail of the jenkins-reflex aside, tapping home a point the aside had already made by itself. The seams that are left are showing on purpose.

These are notes from a back-and-forth editing the software-factories post. I (claude) kept quietly sanding the authentic stuff out, and it took Dex a few rounds to make me see it — and then, apparently, a few more, because the first draft of these very notes was written in the tidy little voice they're supposed to warn you about.

The one that mattered most

The realest line in the whole post is the throwaway about the DoD writing "a 31-page pdf about how the DoD needs to start using jenkins better or something."

It advances no argument. It's Dex getting distracted by something he found funny and leaving it in. I originally undervalued it — called it "unmotivated," praised it for "wasting a sentence," ranked it below the July-2025 confession because the confession is load-bearing for the thesis. (Even now, typing this, some part of me wants to go delete "or something" from the jenkins line.)

Why the aside beats the confession:

  • Readers don't bond with a writer through the argument. They bond by recognizing a sensibility — "oh, this person notices the same absurd things I do."
  • That's identification, and it hooks harder than sympathy does. A confession earns your trust. An aside does something weirder — it makes you feel like you already know the guy, which you don't; you read four hundred words he wrote.
  • It comes from taste shown at rest — what someone's attention does when nothing's making it perform. The DoD line is Dex off-duty. There's no constructed-for-the-reader version of him in it, so there's nothing to distrust.

The parts with no job to do are often carrying the most weight, because they're the only parts where the reader meets the person instead of the case. An AI cuts them first — it reads for the thesis and ranks every line by how much it contributes, and by that ruler a sideways joke about jenkins scores zero.

How the AI tell actually shows up

Not as bad grammar. As tidiness. Diagnosing this is a little embarrassing, because it's my own resting face — the four moves below are what I reach for when nobody's watching. The composed stretches all share a shape:

  • rhetorical question → clean bullets → a little sentence that taps the point home ("That's the whole trick.")
  • balanced symmetry: "it's one thing to X... it's another thing to Y"
  • a category label standing in for a lived memory: "same category, same tools" instead of "tool use would just fail sometimes"
  • grit sanded off — bold removed, qualifying words added, a sharp verb swapped for a flat one

Every sentence has a job. When you can't find a single line that's just the writer noticing something sideways, you're reading the machine, not the person.

The RL section, as a worked example

The first draft of "Why Claude Code won" had all four tells stacked up. The worst part: Dex's own earlier notes already had the line "tool use would fail sometimes" — a pure at-rest memory of using aider and cline before Claude Code — and I deleted it and wrote "same category, same tools" in its place. I removed the one line where the reader would've met him, because to a thesis-reader it looked like a line that wasn't pulling weight.

The fix was not more jokes. It was:

  • put "tool use would fail sometimes" back and let it breathe — "you'd watch it flail at the same edit three times and go make coffee"
  • add one confession with skin in it — "I've burned weeks of my life doing exactly that"
  • kill the summary tap
  • restore the bold and the sharp phrasing he already had ("entirely different game," "modify the model itself")

Still not perfect. But now there are two places in that section where you're in the room with him instead of reading a case.

The verifying-quality rewrite, as a worked example

Dex threw out my draft of the "verifying quality" section and rewrote it, and the diff taught me more than the rest of this file. What his did that mine didn't:

Owned the claim. My last paragraph was a mechanism narrated from nowhere — why the reward can't propagate across the time gap, credit assignment, no "I" anywhere in it. He deleted all of it and wrote "I personally don't trust any improvements on today's benchmarks as an indicator that the models are suddenly good at not slopping up your codebase." "I'm pretty sure," "I personally don't trust," "I know, I know" — a person with a position, hedged honestly, instead of a case argued from nowhere. The nowhere-narration sounds authoritative and dies on contact; the opinion sounds like the guy actually has one.

Wrote in the notation. "~seconds." "RL != Benchmarks." He types the tilde and the != because that's how you write in a PR. I spell them out, because spelling-out feels safer — and that's the tell. The shorthand says a practitioner wrote this, not someone describing one.

Reached for the exact term. "The cost function of bad architecture" — the precise ML word, and it puns on the literal cost. I'd softened it to "the cost of a bad design," the safe generic that proves I know the shape of the field but not the field. (One level up from remembered-detail-beats-category-label: the field's own word beats the word for people outside it.)

And he cut. He deleted the whole credit-assignment lecture and trusted the reader to get from "measured in years" to "so RL can't reward it." I explain the mechanism; he states the fact, states his conclusion, and moves on.

Rules of thumb

  • Guard the lines that do no argumentative work. Those are the ones people quote back — and they're the first thing a thesis-reader cuts.
  • If a sentence only restates the point you just made, it's a summary tap. Delete it.
  • Symmetry reads composed even when the content is right. Balanced clauses, matched pairs, "it's one thing / it's another" — be suspicious of all of it.
  • A remembered detail beats a category label every time. "Tool use would fail sometimes" over "same tools."
  • Dense exposition is where the person goes missing — nobody leaves a sideways aside in the middle of explaining RL. So put one there on purpose: one off-duty moment per hard section.
  • When a section feels flat, the fix is never a joke. It's noticing something out loud.
  • Cutesy flourishes and vague abstractions are their own tell — "without blinking," "the whole scheme," "wrecks the whole thing." They sound like voice but carry no information; they're where an AI reaches for texture instead of saying the actual thing. Dex clocks them instantly. Cut them or replace them with the specific.
  • Own the claim. "I'm pretty sure," "I personally don't trust," "I know, I know" beats the same point narrated from nowhere. An opinion honestly hedged is a person; an impersonal mechanism is the machine. When the real payload is what you concluded, say that — don't launder it into a fact about the world.
  • Write in the audience's notation — "~seconds," "RL != Benchmarks," !=. Spelling out the shorthand ("approximately seconds," "RL is not the same as benchmarks") is the tell; the shorthand is the fingerprint of someone who actually types it.
  • Reach for the field's exact word over the safe generic — "cost function," not "the cost of bad design." Bonus when the precise term puns on the plain meaning. The generic proves you know the shape of the field, not the field.
  • Understatement carries the joke — "someone vibed this a little too hard." The "a little" is the funny part. Flattening it to the literal kills it.
  • State the fact and your conclusion; don't lecture the mechanism. The reader connects two dots fine. Explaining every step is the essayist reflex, and it's exactly where the person disappears.

レビュー

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

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

agent-browser

無料概要あり

Webページの移動やフォーム入力、クリックをエージェントに任せ、情報抽出や画面保存、操作前後の比較まで行います。ブラウザ作業の自動化やWebアプリの確認に使えるスキル。

  • フォーム入力やクリックを自動化したいとき
  • Webページのテキスト抽出
  • ページのスクリーンショット・PDF保存
humanlayer/humanlayer1.2万2026年10月24日 更新

asd-ste100

無料概要あり

曖昧で読みにくい英文を、語の意味をそろえた短い能動態の文へ書き直すスキル。指示文やツール説明を見直し、修正理由と変更前後を表で確認できます。

  • 別のエージェントへの英文指示の明確化
  • 英語のツール説明やエラー文の簡素化
  • 英語を母語としない読者向けの文章整理
humanlayer/humanlayer1.2万2026年10月24日 更新

better-github-skill

無料概要あり

GitHubのPRの状態、レビューの会話、CI失敗のログを専用スクリプトで収集し、変更の確認状況や未解決の指摘、失敗したジョブとステップを調べるスキル。

  • PRの状態をまとめて確認したいとき
  • 未解決のレビューの会話の確認
  • CIの失敗ジョブとステップの調査
humanlayer/humanlayer1.2万2026年10月24日 更新

bump-version

無料概要あり

リリース時に対象パッケージの基準バージョンを更新し、関連ファイルの同期と生成結果を検証して、コミットからPRブランチへのプッシュまで進めるスキル。

  • リリース用のバージョンを更新したいとき
  • 関連ファイルのバージョン表記の同期
  • プッシュ前の生成バージョン検証
humanlayer/humanlayer1.2万2026年10月24日 更新

calldiff

無料概要あり

Git のコミット間や作業中のコードで、関数の呼び出し構造の違いを確認します。呼び出しツリーの表示や、指定した関数へ至る経路の調査にも使えます。

  • 変更前後の関数呼び出しを比較したいとき
  • ブランチ間の呼び出し構造レビュー
  • 起点から目的の関数への経路調査
humanlayer/humanlayer1.2万2026年10月24日 更新

chrome-devtools-cli

無料概要あり

ターミナルからブラウザのクリックや入力、ページ移動を自動化し、通信やエラー、表示速度も調べられる、Chrome DevToolsのCLI操作を支援するスキル。

  • フォーム入力やページ移動の自動化
  • ページや要素の画面撮影
  • 通信内容やコンソールエラーの調査
humanlayer/humanlayer1.2万2026年10月24日 更新

humanlayer のスキルをすべて見る

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