OpenSkillIndex← back to search
claude-codewriting

Claude-skill-registry blog-manager

Use for all blog writing tasks including creating articles (Zenn Japanese, dev.to/Medium English), managing ideas, and setting up blog projects. This is the unified entry point for technical blog writing workflow. Supports idea tracking with status management (backlog/in-progress/done).

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/blog-manager" ~/.claude/skills/majiayu000-claude-skill-registry-blog-manager && rm -rf "$T"
manifest: skills/data/blog-manager/SKILL.md
tags
#writing#content-creation#blogging#idea-management#workflow-automation
source content

Blog Manager Skill

技術ブログ執筆の統合ワークフローを提供するスキルです。

Purpose

  • ブログ執筆プロジェクトのセットアップ
  • 記事アイデアの状態管理（backlog → in-progress → done）
  • 記事の観点（perspective）を適用した記事生成
  • 記事生成（Zenn 日本語 / dev.to・Medium 英語）
  • 公開後のステータス更新とプロモーション支援

Three-Layer Structure

ブログ執筆は「素材」「観点」「成果物」の3層で管理する:

my-blog/
├── ideas/                  # 素材（再利用可能なネタ）
│   ├── YYYYMMDD_langchain-tips.md
│   └── YYYYMMDD_rag-patterns.md
├── perspectives/           # 観点（再利用可能なスタイル）
│   ├── showcase.md         # 製品紹介向け
│   ├── personal.md         # 個人的な考え
│   └── tutorial.md         # ハンズオン教育
├── .draft/                 # 生成された記事（1回の生成結果）
│   └── YYYYMMDD_article-zenn.md
└── articles/               # 公開用
レイヤー役割再利用
ideas/
素材・ネタ（何を書くか）○ 何度でも使える
perspectives/
観点・スタイル（どう書くか）○ 何度でも使える
.draft/
生成された記事× 1回の生成結果

idea と記事は 1:1 ではない:

  • 1つの idea → 複数の記事（違う観点で）
  • 複数の idea → 1つの記事（組み合わせて）
  • 同じ idea を再利用して別の記事に

When to Use

  • 「記事を書いて」「ブログ書いて」と言われたとき
  • Zenn、dev.to、Medium 向けの記事を作成するとき
  • 新しいブログプロジェクトをセットアップするとき
  • 記事アイデアの一覧・状態を確認したいとき
  • 記事を公開した後にステータスを更新するとき

Input Sources

記事の元ネタは以下の2パターンから取得できる:

パターン A: ideas/ から

事前に 

ideas/
にメモしたアイデアから記事を生成:

> ideas/20241215_langchain-tips.md を元に Zenn 記事を書いて

パターン B: 開発ディレクトリから（直接指定）

開発中のプロジェクトの特定機能を直接指定して記事を生成:

> /path/to/project の認証機能について Zenn 記事を書いて
> @myproject/ の LangGraph 実装を dev.to 記事にして
> このリポジトリの MCP サーバー機能について記事を書いて

パターン B のワークフロー:

┌─────────────────────────────────────────────────────────────┐
│  1. ユーザーがディレクトリ + 機能を指定                         │
│     「/path/to/project の認証機能について記事を書いて」         │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  2. 該当コードを探索・読み込み                                 │
│     - README.md があれば読む                                  │
│     - 指定された機能に関連するファイルを特定                    │
│     - 実装の要点を把握                                        │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  3. 記事を生成 (.draft/ に出力)                               │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  4. ideas/ に記録を自動作成（重複防止）                        │
│     ideas/YYYYMMDD_project-name-feature.md                   │
│     status: in-progress                                      │
│     source_path: /path/to/project                            │
└─────────────────────────────────────────────────────────────┘

ideas/ に作成される記録ファイルの例:

---
status: in-progress
priority: high
tags: [authentication, nextjs, security]
created: 2024-01-20
source_path: /path/to/project      # 元のプロジェクトパス
source_feature: 認証機能            # 対象の機能
published_to: []
---

# Next.js 認証機能の実装解説

## 元ネタ

/path/to/project の認証機能から記事を生成

## 記事化のポイント

- JWT トークンの実装
- セッション管理
- ミドルウェアでの認証チェック

これにより:

  • 同じ機能について再度記事を書こうとした時に検知できる
  • 公開後に 
    published_to
    で追跡できる
  • source_path
    で元のコードに戻れる

Perspective (観点)

記事の「観点」は記事生成時に指定する。素材（ideas/）とは独立して管理。

観点の指定方法

# テンプレートを参照
> ideas/20241215_mcp-server.md を showcase の観点で Zenn 記事を書いて

# 直接指定
> ideas/20241215_new-feature.md を記事にして
> 観点: 控えめに、個人的な考えとして表現

# 複数の素材 + 観点
> ideas/20241210_langchain-tips.md と ideas/20241212_rag-patterns.md を
> tutorial の観点で Zenn 記事を書いて

標準 Perspective テンプレート

perspective用途トーン
showcase
製品・ツール紹介熱意あり、使ってもらいたい
personal
個人的な考え・開発記録控えめ、提案ベース
tutorial
ハンズオン教育丁寧、ステップバイステップ
deep-dive
技術深掘り詳細、専門的

詳細は perspectives.md を参照。

生成された記事のメタデータ

.draft/YYYYMMDD_article-zenn.md
には使用した perspective と sources が記録される:

---
title: "LangChain で RAG を実装する実践ガイド"
emoji: "📚"
type: "tech"
topics: ["langchain", "rag", "python", "ai"]
published: false
_meta:
  perspective: tutorial
  perspective_notes: "ステップバイステップで丁寧に"
  sources:
    - ideas/20241210_langchain-tips.md
    - ideas/20241212_rag-patterns.md
  generated_at: 2024-01-20
---

Workflow Overview

┌─────────────────────────────────────────────────────────────┐
│  1. アイデアを ideas/ に追加                                  │
│     status: backlog でフロントマター作成                      │
│     → references/idea-management.md 参照                     │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  2. 記事設計の確認（執筆前に必ず確認）                         │
│     - 読者の前提知識、概念説明の要否                          │
│     - イントロの型（直球型/悩み系/体験ベース/問いかけ型）       │
│     - 文体・避けたいトーン（マーケティング調など）              │
│     - 視覚化の好み（Mermaid/ツリー/表/なし）                   │
│     - 実際の挙動詳細（ツール紹介の場合、対話の流れなど）        │
│     - 補足情報（カスタマイズの余地、代替手段）                  │
│     → references/idea-management.md の「記事の設計」参照       │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  3. 執筆開始                                                 │
│     status: in-progress に更新                               │
│     プラットフォームを選択:                                    │
│     - Zenn (日本語) → references/zenn-guide.md               │
│     - dev.to/Medium (英語) → references/devto-guide.md       │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  4. .draft/ に記事が生成される                                │
│     - .draft/YYYYMMDD_article-zenn.md (Zenn 用)              │
│     - .draft/YYYYMMDD_article-devto.md (dev.to 用)           │
│     - .draft/YYYYMMDD_article-medium.md (Medium 用、オプション)│
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  5. レビュー・編集                                            │
│     - 内容確認、加筆修正                                      │
│     - 画像・GIF を追加                                        │
│     - Zenn: npx zenn preview で確認                          │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  6. 本番ディレクトリに移動                                    │
│     .draft/YYYYMMDD_article-zenn.md → articles/slug.md      │
│     .draft/YYYYMMDD_article-devto.md → external/devto/published/│
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  7. アイデアの status を done に更新                          │
│     published_to に公開先 URL を記録                          │
└─────────────────┬───────────────────────────────────────────┘
                  ▼
┌─────────────────────────────────────────────────────────────┐
│  8. 公開 & プロモーション                                     │
│     → references/promotion-tips.md 参照                      │
└─────────────────────────────────────────────────────────────┘

Platform Selection

ユーザーの要求に応じてプラットフォームを選択:

キーワードプラットフォームガイド
「Zenn」「日本語」「技術記事」Zennzenn-guide.md
「dev.to」「英語」「ローンチ」dev.todevto-guide.md
「Medium」「ストーリー」Mediumdevto-guide.md (Medium モード)
「両方」「マルチ」Zenn + dev.to両方生成

プラットフォームが不明な場合: ユーザーに確認する:

  • 日本語読者向け → Zenn
  • グローバル読者向け → dev.to/Medium
  • 両方 → 両プラットフォーム用を生成

References

ファイル内容
directory-structure.mdプロジェクトのディレクトリ構成
idea-management.mdアイデア（素材）のフロントマター管理
perspectives.md観点テンプレートの定義と使い方
zenn-guide.mdZenn 記事生成ガイド（日本語）
devto-guide.mddev.to/Medium 記事生成ガイド（英語）
promotion-tips.mdプロモーション・タイミング戦略

Usage Examples

1. プロジェクトセットアップ

> ブログ執筆用のプロジェクトをセットアップして

→ directory-structure.md に従ってディレクトリ作成

2. アイデア管理

> ideas/ の backlog を一覧して
> ideas/20241215_xxx.md の status を in-progress にして

→ idea-management.md のフロントマターを操作

3. Zenn 記事生成（ideas/ から）

> ideas/20241215_langchain-tips.md を元に Zenn 記事を書いて

→ zenn-guide.md に従って 

.draft/YYYYMMDD_article-zenn.md
を生成

4. 観点（perspective）を指定して記事生成

> ideas/20241215_mcp-server.md を showcase の観点で Zenn 記事を書いて
> ideas/20241215_new-lib.md を personal の観点で記事にして

→ perspectives/ のテンプレートを適用して記事生成

5. 複数の素材を組み合わせて記事生成

> ideas/20241210_langchain-tips.md と ideas/20241212_rag-patterns.md を
> tutorial の観点で Zenn 記事を書いて

→ 複数の素材を統合し、指定した観点で記事生成

6. 開発ディレクトリから記事生成

> /path/to/myproject の認証機能について Zenn 記事を書いて
> @langgraph-plugin/ の並列処理パターンを showcase で記事にして

→ コードを読み込み → 記事生成 → 

ideas/
に記録を自動作成

7. dev.to 記事生成

> この README を元に dev.to 記事を書いて
> @my-cli-tool/ を showcase で dev.to 記事を書いて

→ devto-guide.md に従って 

.draft/YYYYMMDD_article-devto.md
を生成

8. 両方生成

> ideas/20241215_mcp-intro.md を showcase で Zenn と dev.to 両方の記事を書いて

→ 同じ観点で日本語版と英語版を両方生成

9. 公開後の更新

> ideas/20241215_langchain-tips.md の status を done にして
> published_to に https://zenn.dev/xxx/articles/yyy を追加して

→ フロントマターを更新

10. プロモーション相談

> この記事のプロモーション戦略を教えて

→ promotion-tips.md を参照してアドバイス

Output Files

ファイル説明
.draft/YYYYMMDD_article-zenn.md
Zenn 用日本語記事
.draft/YYYYMMDD_article-devto.md
dev.to 用英語記事
.draft/YYYYMMDD_article-medium.md
Medium 用英語記事（オプション）

ファイル名の形式: 

YYYYMMDD_
は生成日の8桁日付（例: 
20241215_article-zenn.md
）

記事生成時の確認チェックリスト

ユーザーから「記事を書いて」と依頼されたとき、以下の情報が不足していれば確認する:

項目確認が必要な場合質問例
読者の前提知識対象が不明確「読者は◯◯を知っている前提でよいですか？」
概念説明の要否ツール/技術紹介「◯◯とは何かの説明は必要ですか？」
イントロの型特に指定がない「直球型・悩み系・体験ベースなど、イントロの好みはありますか？」
避けたいトーン特に指定がない「避けたい表現やトーンはありますか？」
視覚化の好み構造を説明する内容「図（Mermaid等）を使いますか？テキストで十分ですか？」
実際の挙動ツール/機能紹介「ユーザーが◯◯すると何が起こりますか？」
補足情報カスタマイズ可能なツール「読者が調整できる部分や代替手段も触れますか？」

ポイント: これらを最初に確認することで、執筆後の手戻りを大幅に減らせる。

Notes

  • すべての記事生成は 
    .draft/
    に出力（一時置き場）
  • 完成したら 
    articles/
    (Zenn) または 
    external/
    (他) に移動
  • アイデアの状態管理で重複記事を防止
  • 同じアイデアを複数プラットフォームに投稿可能（
    published_to
    で追跡）
  • 生成後の細かい修正は、手動で編集しても Claude Code に依頼してもよい