japanese-tech-writing/SKILL

SKILL.md name japanese-tech-writing description 日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。 日本語技術文書の文章規範 日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。 整形 一文ごとに改行する。段落の区切りは空行で示す。 コード、差分、ログ、設定ファイルの断片はコードブロックで示す。 用語の由来や定式化の名称など、本筋から一段外れる補足は、本文に並べず脚注（[^ラベル]）に降ろす。 定義や分類の列挙は

[golden-lucky]

すごいたくさんブックマークされてるのにいまごろ気づきました。SKILL.mdという仕組み自体がよく理解されてないような雰囲気を感じるので、そこから調べることをお勧めします！

[securecat]

うーん　これで守れるかな、、、LLMにLLMっぽいの禁止みたいなロジックのナンセンスさも

[roshi]

「句読点は、。でなく，．で書く」もありそう。いつまで学生気分なんだと思うけど。

[koroha-a]

いくつかは普段から守らせたいな。冗長で曖昧な言い回しでコンテキスト消費されて嫌気が差してくることも多い

[takilog]

なんでこんなにブクマされてるんだ、SKILL理解してるか本当に

[t-wada]

鹿野さんによる、LLMにまともな技術文章を書かせるための Agent Skill

[north_korea]

出版社をやっている人が作ったスキルだから完成度高いな

[pmint]

そんな文章はZennでも見ない。検証した？なぜAIに書いてもらわないの。これはこれで「鹿野臭い」と言われてしまう罠。本人含め「SKILL理解してるか」はAI分かってない人。「句点で二文に分ける」2行になっちゃうな（笑。

[nakagawax]

マニュアル作成に活かせそう！

[Nyoho]

出版業界の方の注意すべきところが読めるだけでも役に立つね。しかもスキルとして、自動的にそれが適用できるとなれば、なおさら

[sigC]

これはAIエージェントに読ませるものだと知らない人が結構いるのか。markdownがgithubやgistでは成型されて表示されるのも誤解の一因かも（いやそもそもそういうフォーマットなんだけど）

[S_Maeda]

“整形 一文ごとに改行する。段落の区切りは空行で示す。 コード、差分、ログ、設定ファイルの断片はコードブロックで示す。 用語の由来や定式化の名称など、本筋から一段外れる補足は、本文に並べず脚注（[^ラベル]）

[mcddx30]

https://www.techno-edge.net/article/2026/06/22/5209.html

[short13]

どこらへんがSKILL理解されてないような雰囲気なんだろ？誰か教えて。

[shoh8]

“SKILL.md”

[l_etranger]

実際にSKILL.mdとして使う人がどれだけいるかは分からないが読むだけでも結構楽しい。"「AではなくB」という対句の決め台詞を多用しない。"わーかーるー。その他，空虚な形容，空虚な動詞，微妙にはまってない比喩 etc...

[kiririmode]

技術文書・書籍原稿の文章規範を示すSKILL

[sumar5]

“LLMに悩ましい日本語を生成させないためのSKILL”

[bash0C7]

日本語技術文書の文章規範

[michael-unltd]

“日本語の技術文書・書籍原稿の文章規範”

[pure_luca]

“日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。”

[sionsou]

参考に

[misshiki]

日本語技術文書向けの文章規範。整形、段落構成、論証の厳密さ、読者負荷、語り、演出抑制、LLMっぽい空句禁止、冗長排除を具体ルール化。

[takashiski]

ここはたぶんmdだからだよね“一文ごとに改行する。段落の区切りは空行で示す。”

[hom_functor]

プロの仕事に前提も確認しない素人がいちゃもんつけるいつものはてブ

[outalaw]

プロンプトとのことだけど、人間がモノを書くときに気をつけていて良いことばかり

[rawwell]

"空虚な動詞：「掘り下げる」「深掘りする」「言語化する」（何をどう書いたかを示さず終わる）、「触れる」「言及する」（一段落で済ませるだけ） "

[for-my-internet-demo]

単に自分の俺俺スキルとの差分見てるだけだろ全員

[FunnyBunnyDizzy]

技術書の編集に関わっている人がこういうの言語化してくださるのは本当にありがたい

[eachtime]

いや結構クセ強めですよ、これ。

[touhousintyaku]

コメント数をブクマ数と見間違えて「28件か、言うほど多いかな？」と思ったら669usersで草

[jintrick]

低脳モデル使いとしては、こんな大量のプロンプトを網羅的に処理できるとは思えないね。これを確実にやらせるなら、５つくらいの専門エージェントに直列処理させるね俺なら。あと、決定論的な部分はスクリプト（ｒｙ

[agrisearch]

「日本語技術文書の文章規範」

[yto]

あとで試してみる