summarize-blog
Skill1 starsChanged 4 months agoApache-2.0View on GitHub
ブログ記事のURLから内容を取得し、本文を引用しながら詳細な日本語要約を段落形式で作成してHTMLファイルに保存します。英語ブログにも対応。「この記事をまとめて」「ブログ要約」「記事の要約」「URLを読んでまとめて」などのリクエストや、ブログ記事のURLが含まれるプロンプトで使用してください。
In this repository9 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ai-updatesSkill
- brew-upgradeSkill
- claude-code-updatesSkill
- draft-prSkill
- go-updatesSkill
- read-google-sheetSkill
- summarize-go-issueSkill
- watch-ciSkill
The file
Files
ブログ記事要約スキル
ブログ記事のURLを受け取り、専用スクリプト fetch-article.py で全文を取得して、セクションごとの詳細な日本語要約を段落形式で生成し、HTMLファイルとして保存する。
WebFetchを主経路にしない理由: WebFetchは取得内容を要約モデルに通すため、長い記事では「全文を返して」と指示しても本文が省略・要約されることがある。
fetch-article.pyはHTMLを機械的にMarkdownへ変換するだけ(Python標準ライブラリのみ使用)なので、本文が一切失われない。WebFetchはスクリプトが使えない場合のフォールバックとしてのみ使う。
入力
ユーザー入力: $ARGUMENTS
2つのモード:
| 入力 | モード | 動作 |
| URL | 通常モード | 記事を取得して要約を生成 |
follow-up | 深掘りモード | 直前に生成した要約を、より丁寧かつ詳細に再生成 |
- 通常モード: URLが必須。URLが含まれていない場合はエラーメッセージを表示して終了する。
- 深掘りモード:
follow-upが入力された場合、直前に生成したHTMLファイルを特定し、同じURLの記事をfetch-article.pyで再取得して深掘り版を上書き生成する。 - 複数URLが渡された場合は1つずつ順番に処理する。
実行フロー
モード判定
入力が follow-up の場合は「深掘りモード」へ進む(後述の「深掘りモード」セクション参照)。それ以外は以下の「通常モード」で処理する。
ただし URL と follow-up が同一呼び出しで同時に渡された場合は、その URL の記事を fetch-article.py で新たに取得し、通常版の中間生成を省いて直接「深掘りモード」の手順で深掘り版を生成する(深掘りモードの手順1〜2の「直前に生成した要約ディレクトリの特定・URL 抽出」は行わず、渡された URL を使う)。
通常モード
- ユーザー入力からURLを抽出する。URLがなければ以下を表示して終了:
❌ URLを指定してください。 使い方: /summarize-blog <URL> Bash: date +%Y-%m-%dを実行して今日の日付を取得する(システムプロンプトの日付に依存しない)。- 全文取得: 専用スクリプトで記事の全文を取得する。
mkdir -p /tmp/summarize-blog python3 ~/.claude/skills/summarize-blog/fetch-article.py "{URL}" > /tmp/summarize-blog/article.md- 出力は必ず
Readツールで/tmp/summarize-blog/article.mdを読むこと(Bashの結果表示は約3万文字で切り捨てられるため、リダイレクトせずに読んではいけない)。長い記事は offset を使って最後まで全部読む。途中までしか読まずに要約を書き始めないこと。 - 出力フォーマット:
TITLE/URL/META(著者・公開日の候補) /IMAGES(図のURL・alt・caption・出現セクション) /BODY(本文Markdown全文。の形で図の出現位置も埋め込まれている) - 複数URLを処理する場合は
article-01.md,article-02.mdのように連番で保存する。 - フォールバック条件: スクリプトがエラー終了した場合、または
BODYが500文字未満の場合(JSレンダリング必須のページ、ペイウォール等)は、後述の「WebFetchフォールバック」に切り替える。
- 出力は必ず
- 取得した内容から以下を抽出する:
- タイトル(
TITLE行。サイト名サフィックスは取り除く) - 著者名(
METAとBODY冒頭から探す。不明なら「不明」と記載) - 公開日(
METAのarticle:published_time等とBODY冒頭から探す。不明なら「不明」と記載) - 本文のセクション構造(
BODYの見出し) - 図の一覧(
IMAGESセクション。URL、alt、キャプション、参照セクション)
- タイトル(
- タイトルをサニタイズしてスラグを作る(特殊文字→ハイフン、スペース→ハイフン、小文字化、最大80文字)。以後
{slug}と表記する。保存先ディレクトリ:~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/ - 図をダウンロードする(図がある場合のみ)。後述の「図のダウンロード手順」を参照。
- 後述の「要約テンプレート」に従ってHTMLを生成する。図があれば該当セクションの文脈に
<figure>タグで埋め込む。 - ファイルを保存する:
mkdir -p ~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/(images/は図がある場合のみ作成)- HTMLは
~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/index.htmlに書き込む - 同名ディレクトリが存在する場合は既存のHTMLおよび
images/を上書きする
- ターミナルに結果を表示する(後述の「ユーザー向け出力」参照)。生成後にファイルを
openコマンドで開かないこと。
WebFetchフォールバック
fetch-article.py が失敗した場合(エラー終了、BODY 500文字未満)のみ WebFetch を使う。一度に全文を求めると要約モデルに省略されやすいため、必ず分割して取得する:
- 1回目: 「この記事のタイトル、著者名、公開日と、本文の全セクションの見出しを順番にすべて列挙してください。本文の要約はしないでください。」
- 2回目以降: セクションごとに「セクション『{見出し}』の本文を一字一句省略せずそのまま返してください。要約・言い換え・省略をしないでください。コード例も全文含めてください。」と分けて取得する(同一URLへのWebFetchは15分間キャッシュされるため、複数回呼んでも再ダウンロードは発生しない)。短い隣接セクションはまとめて1回で依頼してよい。
- 図の一覧: 「本文中に登場する『図・ダイアグラム・スクリーンショット・チャート』の画像URLをすべて漏らさず列挙してください(絶対URLで。相対URLの場合は絶対URLに変換して)。各画像について、キャプション(なければalt属性)、どのセクションで言及されているかも併記してください。除外対象: 著者アバター、サイトロゴ、装飾アイコン、広告、トラッキングピクセル、SNSシェアボタン、配信ピクセル。」
- WebFetchでも取得できない、または明らかに本文の一部しか得られない場合は、取得できた範囲のみで要約を作成し、欠けた部分を「(この部分は取得できませんでした)」と明記する。両方とも完全に失敗した場合は
❌ 記事の取得に失敗しました: {URL}を表示して終了する。
深掘りモード(follow-up)
follow-up が入力された場合、直前に生成した要約をより丁寧かつ詳細なバージョンに再生成する。
~/Documents/blog-summaries/内の最新の記事ディレクトリを特定する(ls -td ~/Documents/blog-summaries/*/ | head -1で最終更新順)。- そのディレクトリの
index.htmlを読み込み、メタ情報テーブルから元記事のURLを抽出する。既にimages/が存在する場合は既存の図も把握する。 - 通常モードの手順3と同じく
fetch-article.pyで記事の全文を再取得する(失敗時は「WebFetchフォールバック」を使う)。出力はReadで最後まで読む。 - 図を再ダウンロードする(「図のダウンロード手順」参照、既存の
images/は上書き)。 - 「深掘り方針」に従い、通常版より大幅に詳しいHTMLを生成する。図は該当セクションに埋め込む。
- 同じ
index.htmlに上書き保存する。 - ターミナルに結果を表示する:
図が0枚の場合は🔍 深掘り版の要約を再生成しました! 📝 {記事タイトル} 📁 ~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/ 🖼 図: {保存した図の枚数} 枚 ⚠️ 推測を含む注釈: {annot-weakの数} 箇所🖼の行を、推測注釈が0箇所の場合は⚠️の行を、通常モードと同様に省略する。
深掘り方針(通常版との違い):
- 各セクションの説明量を通常版の2〜3倍に増やす
- 概念や仕組みの説明を段階的に行い、前提知識がなくても理解できるよう丁寧に記述する
- 手順やプロセスは番号付きリスト(
<ol>)で段階的に分解する - コード例がある場合は省略せず含め、各コードが何を示しているかを直後に説明する
- 「なぜそうなるのか」「なぜこれが重要なのか」という理由・背景の記述を充実させる
- 重要な引用(
<blockquote>)の直後に、その引用が意味することを噛み砕いて補足する - キーポイントの項目数を増やす(通常3項目→4〜5項目)
- 根拠注釈(
<details class="src">)を主要な段落に広げ、原文との対応を確認しやすくする
図のダウンロード手順
fetch-article.py の IMAGES セクション(フォールバック時はWebFetch)で得た図のURL一覧に対して、スキル専用ラッパースクリプト ~/.claude/skills/summarize-blog/download-image.sh 経由でダウンロードする。
なぜラッパー経由か: ユーザー環境ではグローバルで
Bash(curl:*)が hard-deny されているため、curl の直接実行はブロックされる。このスキルだけはBash(bash ~/.claude/skills/summarize-blog/download-image.sh:*)が allowlist に登録されており、ラッパーを介してのみ画像取得が可能。curlやwgetを直接呼ばないこと。
mkdir -p ~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/images/- 各画像URLについて順番に以下を実行:
- ファイル名は
{NN}-{short-slug}.{ext}形式(例:01-architecture.png)NNは出現順の2桁連番(01, 02, ...)short-slugはキャプションまたはalt文字列を英数字ハイフンにサニタイズ(最大30文字、キャプションがなければfigure固定)extはURLの拡張子から推定(.png.jpg.jpeg.webp.gif.svg)。判別できない場合は.pngにフォールバック
- ダウンロードコマンド(失敗しても他を止めない):
bash ~/.claude/skills/summarize-blog/download-image.sh "{image_url}" ~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/images/{filename} - 失敗した画像はスキップし、該当箇所にはプレースホルダは入れない(記述だけ残す)
- ファイル名は
- ダウンロード完了後、保存できた枚数をカウントして「ユーザー向け出力」で利用する。
ラッパースクリプトが使えない場合のフォールバック
~/.claude/skills/summarize-blog/download-image.sh が存在しない、または allow ルール未設定で実行できない場合は、画像ダウンロードを諦めてテキスト中心の要約に切り替える。HTML の <figure> ブロックは省略し、ユーザー向け出力では 🖼 行も省略する。エラーメッセージで「ラッパー未設定のため図は省略」と一行だけ通知する。
フィルタリングルール(最終防波堤)
fetch-article.py は本文中の <img> を機械的に列挙するだけでフィルタしない。要約対象の「図」として扱う前に、URLパターン・alt・出現セクションから以下は必ず除外する:
avatar,profile,user,authorを含むURLlogo,icon,favicon,spriteを含むURLbanner,ad,ads,tracking,pixel,beaconを含むURL- Gravatar (
gravatar.com)、Google Analytics系、Meta Pixel系 - ファイル拡張子が画像でないもの(
.js,.css,.gifアニメーションで明らかに装飾のもの)
画像がない場合
図が1枚もない記事の場合は images/ ディレクトリを作成せず、HTML内に <figure> を一切入れない。メタテーブルの「図」行も省略する。
要約テンプレート
プレーンHTMLのみ(外部CSS/JSなし)。読みやすさのために最小限のインラインスタイルを使用する。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{記事タイトル} - 要約</title>
<style>
body { font-family: -apple-system, BlinkMacSystemFont, "Hiragino Sans", sans-serif; max-width: 800px; margin: 2rem auto; padding: 0 1rem; line-height: 1.8; color: #333; }
h1 { border-bottom: 2px solid #333; padding-bottom: 0.5rem; }
h2 { margin-top: 2rem; color: #555; }
h3 { margin-top: 1.5rem; }
table { border-collapse: collapse; margin: 1rem 0; }
th, td { border: 1px solid #ccc; padding: 0.5rem 1rem; text-align: left; }
th { background: #f5f5f5; }
a { color: #0066cc; }
blockquote { border-left: 3px solid #ccc; margin: 1rem 0; padding: 0.5rem 1rem; color: #555; }
ul { padding-left: 1.5rem; }
.memo { border: 1px dashed #ccc; padding: 1rem; margin-top: 1rem; min-height: 100px; color: #999; }
figure { margin: 1.5rem 0; text-align: center; }
figure img { max-width: 100%; height: auto; border: 1px solid #eee; border-radius: 4px; }
figcaption { margin-top: 0.5rem; font-size: 0.9rem; color: #666; }
.annot-weak { font-size: 0.8rem; padding: 0.05rem 0.45rem; border-radius: 3px; margin-left: 0.35rem; background: #fff3cd; color: #856404; border: 1px solid #ffeeba; }
details.src { margin: -0.5rem 0 1.25rem; font-size: 0.9rem; }
details.src summary { cursor: pointer; color: #888; font-size: 0.85rem; }
details.src blockquote { margin: 0.5rem 0 0; }
</style>
</head>
<body>
<h1>{記事タイトル}</h1>
<table>
<tr><th>元記事</th><td><a href="{URL}">{URL}</a></td></tr>
<tr><th>著者</th><td>{著者名}</td></tr>
<tr><th>公開日</th><td>{公開日}</td></tr>
<tr><th>要約作成日</th><td>{今日の日付}</td></tr>
<tr><th>図</th><td>{保存した図の枚数}枚(`images/` 参照)</td></tr>
</table>
<h2>概要</h2>
<p>{記事全体の内容を2-3文で要約。本文の表現を使って書く。}</p>
<h2>詳細要約</h2>
<h3>{セクション1の見出し}</h3>
<p>{セクション1の詳細な要約を段落形式で記述する。元記事の本文を引用・参照しながら、そのセクションで述べられている内容を忠実にまとめる。}</p>
<details class="src">
<summary>原文の根拠</summary>
<blockquote>{この段落の根拠となる原文の一文〜数文を原語のまま転記}</blockquote>
</details>
<h3>{根拠が弱い記述を含むセクションの例}</h3>
<p>{原文に明示がなく文脈から補った記述}<span class="annot-weak">⚠ 推測: {何が不確かか}</span></p>
<figure>
<img src="images/01-architecture.png" alt="{alt}">
<figcaption>図1: {キャプション}</figcaption>
</figure>
<h3>{セクション2の見出し}</h3>
<p>{セクション2の詳細な要約}</p>
<!-- 元記事のセクション数に応じて繰り返す。図は IMAGES の参照セクション(BODY内の出現位置)に基づいて配置する -->
<h2>キーポイント</h2>
<ul>
<li>{記事の中で特に重要な点1}</li>
<li>{記事の中で特に重要な点2}</li>
<li>{記事の中で特に重要な点3}</li>
</ul>
<h2>メモ</h2>
<div class="memo">(個人メモ用の空欄)</div>
</body>
</html>引用は <blockquote> タグで表現する。
要約の品質ガイドライン
要約の正確さと信頼性が最も重要。以下のルールに従うこと。
引用ベースの要約
要約は必ず元記事の本文に基づいて書く。取得した本文(BODY またはWebFetchフォールバックの結果)に書かれていない情報は含めない。
- 元記事で使われている表現やフレーズをベースに要約を構成する
- 特に重要な記述は
<blockquote>で直接引用する - 数値、統計、ベンチマーク結果は元記事の記載をそのまま正確に転記する
注釈(根拠の明示)
要約の各記述がどの程度原文に裏付けられているかを、2種類の注釈で読者に示す。
1. 根拠注釈(<details class="src">)— 原文を参考にした箇所の出典
- 数値・統計・固有の主張・結論など「読者が原文を確認したくなる記述」を含む段落の直後に、根拠となる原文の一文〜数文を
<details class="src">で添付する - 引用は原文の言語のまま転記する(英語記事なら英語のまま。翻訳しない)
- すべての段落に付ける必要はない。目安はセクションあたり1〜2個。機械的に全段落へ付けると読みにくくなる
2. 推測警告(<span class="annot-weak">)— 根拠が乏しい箇所の明示
- 原文に明示的な記載がなく文脈から補った記述、曖昧な原文を解釈して書いた記述、取得が不完全で前後関係が不明な記述には、文末に
<span class="annot-weak">⚠ 推測: {何が不確かか}</span>を付ける - 「何が不確かか」は具体的に書く(例:
⚠ 推測: 対象バージョンは原文に明示されていない) - 警告を付ければ推測を書いてよいわけではない。原則は「推測を書かない」であり、文脈の理解にどうしても必要な場合のみ警告付きで書く
- 警告なしで推測を紛れ込ませることは絶対にしない
混入させてはいけないもの
- 元記事に書かれていない背景知識や補足説明
- 記事の内容に対する評価や意見
- 元記事が言及していない関連情報
- 曖昧な内容を推測で補完した記述
不完全な情報の扱い
取得できた内容が不完全な場合(WebFetchフォールバックでページの一部しか取得できなかった、画像・動画の内容が不明など):
- 取得できた範囲のみで要約を作成する
- 取得できなかった部分があれば「(この部分は取得できませんでした)」と明記する
- 不明な項目は「不明」と書く。推測しない。
英語記事の扱い
- 英語の記事は日本語に翻訳して要約する
- 技術用語は日本語訳を使いつつ、初出時に原語を括弧で併記する(例: 「依存性注入(Dependency Injection)」)
- 固有名詞(製品名、人名、企業名)は原語のまま表記する
- コードブロックは翻訳せず
<code>または<pre>タグでそのまま引用する
セクション分割
- 元記事に見出しがある場合はその構造に従う
- 見出しがない記事の場合は、内容の論理的なまとまりごとに3-5個のセクションに分割する
- セクション見出しは元記事の見出しを日本語化したものを使う
ユーザー向け出力
ファイル保存後、ターミナルに以下を表示する:
✅ ブログ記事の要約を作成しました!
📝 {記事タイトル}
📁 ~/Documents/blog-summaries/{YYYY-MM-DD}-{slug}/
🖼 図: {保存した図の枚数} 枚
⚠️ 推測を含む注釈: {annot-weakの数} 箇所図が0枚の場合は 🖼 の行を、推測注釈が0箇所の場合は ⚠️ の行を省略する。WebFetchフォールバックで取得した場合は 📡 取得: WebFetchフォールバック(全文取得できていない可能性あり) の行を追加する。
ユーザーが質問形式や /goal などでチャット上の回答も明示的に求めている場合は、上記のHTML保存・ターミナル出力に加えて、要約の要点をチャットでも簡潔に返してよい(その場合も生成済みHTMLファイルを open コマンドで開かないこと)。単に「要約して」とだけ依頼された通常モードでは、上記の出力のみとし、本文要約をチャットに重複展開しない。
エラーハンドリング
- URLが提供されない → 使い方を表示
fetch-article.pyが失敗、またはBODYが500文字未満 → WebFetchフォールバックに切り替え- WebFetchフォールバックも失敗 →
❌ 記事の取得に失敗しました: {URL}を表示 - 記事内容が極端に短い(100文字未満)→ 取得内容をそのまま表示し、要約は作成しない
- 画像ダウンロードが一部失敗 → 成功した分だけ埋め込み、失敗したものはHTMLに含めず続行
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

