h2に絵文字なし。短い段落。スクショでターミナル実行結果を見せる。コマンドの.mdファイル内容を丸ごとコードブロックで公開。catnose氏と同じく「人間に分かりやすい文章」が得意な書き手。
knowledgework — knip × AIエージェント
AIへの指示文をコードブロックで表示。「knipを使って無駄コードを掃除して。」のように自然言語をそのままコードブロックに入れている。
NUCHIの指摘: 「h2見出しにemojiを使うのは"AIっぽい = AI任せの低品質なもの"と連想されがちだから、ない方がいいかも」
対応方針: Zenn記事のh2から絵文字を全て削除する。テキストのみの見出しに。
NUCHIの指摘: 「"このリポジトリを分析させて"とあるが、記事内にリポジトリが書いてないかも?」
対応方針: 記事末尾の「Claude Codeに読ませてみて」の直前にGitHubリポジトリURLを追加。
NUCHIの指摘: 「AIへの指示文の例はcodeblockの方がわかりやすい」(参考: knip記事)
対応方針: 「赤坂1丁目の土地の相場教えて」などの入力例をコードブロックで表示する。knip記事のように、自然言語をそのままコードブロックに入れるスタイル。
NUCHIの指摘: 「使ってる技術とか書いた方がいいかも。自然言語で完結させているなら、そういう戦略的なものも書きつつ、SKILL.mdを公開してもいいなら記事内にコードブロックで貼っちゃった方が楽かも」
対応方針: このプラグインは意図的にコードを書かず、自然言語のみで構成している(Markdown 3ファイルだけ)。これは「戦略」として記事で強調する価値がある。SKILL.md をコードブロックで全文掲載し、「これが全てです」と見せる。
yoshiko記事も .md ファイルの全文をコードブロックで公開しており、読者の理解が深まるスタイル。
確認事項: SKILL.md に機密情報がないか要チェック(APIキー等 → 確認済み、なし)。
NUCHIの指摘: 「自然言語で完結させているmdファイルなのであれば、pluginではなくskillだけで良いかも(pluginが必要なケースは相当珍しいはず)」
現状: reinfolib-plugin は以下の3ファイルで構成されている:
.claude-plugin/plugin.json — プラグイン定義commands/price-check.md — スラッシュコマンドskills/price-analysis/SKILL.md — 分析手順書分析: skill 単体で提供すると、スラッシュコマンド(/price-check)が使えない。SKILL.md だけなら自然言語トリガーのみになる。plugin にしている理由は「確実に起動できるスラッシュコマンド」を提供するため。
対応方針: 記事内で「なぜ plugin として構成したか」を1文で説明する。「スラッシュコマンドで確実に起動させたいので plugin にした。skill だけでも自然言語トリガーで動くが、不動産分析のような重いタスクは明示的にコマンドで起動する方が安全」という趣旨。
NUCHIの指摘: 「文章は減らして、スクショに置き換えれるところはそうした方がいい記事になるかも、特にターミナルのところとか」(参考: yoshiko記事)
対応方針: 以下の箇所でスクリーンショットを撮影して差し替える:
/price-check 港区赤坂1丁目 を実行した時のターミナル画面スクリーンショットの撮影はユーザー側の作業。素材をもらえれば記事に組み込む。
NUCHIの指摘: 「yoshikoはcatnoseと同じようにhumanにわかりやすい文章や伝え方が得意」
yoshiko記事の特徴(分析結果):
対応方針: 記事全体をyoshikoスタイルに寄せる。段落を短くし、技術的な説明は「ざっくりいうと」で導入してから詳細に入る。冒頭に軽い自己紹介を入れる。
1. 即座に対応(機械的に修正できる)
- h2の絵文字削除
- リポジトリURL追記
- 指示文のコードブロック化
2. 記事構成の変更(書き直しが必要)
- SKILL.md全文掲載 + 「コードゼロ戦略」の説明追加
- pluginにした理由の説明追加
- 文体をyoshikoスタイルに改善(短い段落、平易な導入)
3. ユーザー作業が必要
- ターミナルのスクリーンショット撮影(実行時の画面と出力レポート)