blog-writer

Files (4)

• SKILL.md
• api.md · references/
• guide.md · references/
• .gitkeep · scripts/

SKILL.md (first lines)

# Blog Writer Skill

このスキルは、AI駆動の執筆活動を効率化し、読者にとって価値のある洗練されたブログ記事を作成するための「編集・執筆」の専門知識を提供します。

## 使用タイミング (When to Use)

- 履歴解析ツール等によって収集された素材を元に、清書したいとき。
- 箇条書きのメモから、読みやすいブログ記事を生成したいとき。
- 既に書かれた記事の SEO 改善や、ターゲット読者に合わせたトーン調整を行いたいとき。

## 基本機能 (Core Features)

### 1. 記事構成の提案
トピックや素材を元に、論理的で読みやすい章立て（H2, H3）を設計します。

### 2. コンテンツの生成・改善
- **リード文**: 読者の関心を惹きつけ、記事を読むメリットを明確に伝えます。
- **文章作成**: 読者のレベル（初学者〜上級者）に合わせ、技術的な概念を噛み砕いて説明します。
- **Mermaid図解**: 文章の理解を補完する視覚的なフロー図を生成します。

### 3. SEO・メタ情報の最適化
- 検索意図を汲み取ったタイトルの提案。
- リンククリックを促すメタディスクリプションの作成。
- 記事の構造を Google 検索エンジンに伝えやすく整理。

## 執筆プロセス (Workflow)

1.  **素材の受け取り**: トピック、ターゲット、および執筆の元となる素材（技術詳細やメモ）を確認。
2.  **構成案作成**: アウトラインを提示し、ユーザー（編集長）の承認を得る。
3.  **セクションごとの執筆**: 構成に沿って、一貫性のある文章を生成。
4.  **最終推敲**: 装飾、図解の追加、SEOメタ情報の生成。

## ベストプラクティス

- **読者ファースト**: 専門用語を並べるだけでなく、その意味や文脈を解説する。
- **構造化**: 箇条書きや強調、引用を適切に使い、スマートデバイスでも読みやすくする。
- **誠実さ**: 可能な限り検証可能なコードや事実に基づき、憶測を避ける。

From Keiji-Miyake/kanon-ag, MIT.

More from Keiji-Miyake/kanon-ag