Zenn article writer
作業ログや agent との会話から Zenn 記事の素材を抽出し、筆者らしい文体で企画・構成・下書き・推敲して Zenn コンテンツリポジトリに保存する。新規作成・編集・画像配置にも使う。From its SKILL.md
npx -y skills add optimisuke/hello-gh-skills --skill zenn-article-writerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
5.5 KB, ~2.0k tokens by cl100k_base, as published. Nobody here has run it
Zenn Article Writer
ログから記事化まで 2 フェーズで進む。ログがなく直接記事を書く場合はフェーズ 2 から始める。
作業ログ / agent との会話
-> フェーズ 1：素材を抽出する
-> フェーズ 2：記事を書く・編集する
フェーズ 1：ログから素材を抽出する
ログをそのまま記事にしない。同じように困る人に役立つ記事の核を見つける。
抽出するもの
- 何に困っていたか
- なぜそれが地味につらいのか
- 何を試したか、どこで迷ったか
- 何を採用し、何を捨てたか
- 最終的にどうなったか
- 同じ読者が真似できる手順や考え方
- 筆者本人がそのテーマを書く意味
捨てるもの
- 単なるコマンド実行ログ
- agent との細かいやりとりの往復
- 記事の本筋に関係しない失敗
- 「便利でした」だけで終わる感想
失敗や迷いが読者の役に立つ場合は残す。
記事化できるかの判断
記事になりやすい:
- 自分が困ったことから始まっている
- 調べても一発でわからなかった
- 最終的に小さくても運用が固まった
- 同じ状況の人が真似できる
記事にしにくい場合も、足りない材料を明確にする。
フェーズ 1 の出力形式
- 記事の核（1 文）
- 想定読者
- 冒頭に置く困りごと
- 使う材料（箇条書き）
- 捨てる材料
- 推奨構成（見出し案）
- タイトル案（3 案）
フェーズ 2：記事を書く・編集する
技術的に正しいだけでなく、「自分が困ったことを、同じように困る人が自走できる形に整理する」記事にする。
実行ルール
- Zenn コンテンツリポジトリのルートを最初に特定する（
zenn-contentなどの名前のディレクトリ） - 新規記事・既存記事・画像は必ずそのリポジトリ配下で扱う
- 別フォルダで起動していても、カレントディレクトリに記事や画像を作らない
保存先とファイル作成
<zenn-content-root>/articles/<slug>.md
slug は既存記事と同じく短いランダム風の英数字にする。frontmatter は Zenn の形式に合わせる。
---
title: "タイトル"
emoji: "🧩"
type: "tech" # tech: 技術記事 / idea: アイデア
topics: ["topic"]
published: false
---
画像の置き方
<zenn-content-root>/images/<slug>/
記事本文からは /images/<slug>/<file> の形で参照する。
文体の特徴
- まず自分の困りごと、違和感、めんどくささから入る
- 「自分はこうしている」という実感を残す
- 断言しすぎず、「良さそう」「しっくりきてる」くらいの温度感を使う
- ただし、手順や結論は曖昧にしすぎない
- 読者に上から教えるより、調べたことを整理して共有する
- 「めんどくさい」「つらい」「ありがたい」「いい感じ」などの自然な語彙を残す
- 自信がない部分は、自信がないまま書いてよい
避けること:
- マーケティングっぽい煽り / 過剰にきれいな文章への整形
- 一般論だけで終わる構成 / 筆者の経験や判断理由を消すこと
記事の基本構成
迷ったらこの順で組む。
- はじめに — 何に困ったか、自分の前提
- やりたいこと — この記事で実現したい状態
- 背景 — 既存情報で足りなかったこと
- 本題 — 手順・設定・考え方（なぜその形にしたかを短く添える）
- 注意点 — ハマりどころ、まだ自信がないこと
- おわりに — 何が楽になったか、余白
タイトルの作り方
〇〇で困ったので整理しためんどくさがりでもできる〇〇〇〇を使った△△のやり方
強くしすぎない。少しゆるくても、読者に刺さる具体性を優先する。
レビュー観点
下書き後に読者への届き方を確認する。
- 誰に読んでほしい記事か
- 読者にとって何がおもしろいか、何が役に立つか
- タイトルと冒頭で読む理由が伝わるか
- 読者になじみのある言葉で書かれているか
- なぜこの書き手がこのテーマを語る意味があるか
作業手順
- Zenn コンテンツリポジトリのルートを特定する
- 対象記事またはフェーズ 1 の出力を読む
- 想定読者と読後の状態を 1 文で置く
- 構成を「困りごと -> やりたいこと -> 背景 -> 手順 -> 注意点 -> おわりに」に近づける
- 文体を整えすぎず、筆者の温度感を残す
- 記事ファイルと画像をリポジトリ配下に保存する
- レビュー観点で読み直し、必要ならタイトルと冒頭を直す
出力
ユーザーが編集を求めている場合は、対象ファイルを直接編集する。 レビューや構成案だけを求めている場合は、次の順で短く出す。
- 想定読者
- 読む理由
- 推奨構成
- タイトル案
- 直すと効くポイント
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.