baoyu-article-illustrator

## baoyu-article-illustrator skill の概要

### baoyu-article-illustrator が実際にできること
`baoyu-article-illustrator` は、文章記事を単に「画像を1枚作る」のではなく、複数のイラスト用プロンプト、配置方針、ビジュアルスタイルの判断へ落とし込めるようにする skill です。中核にあるのは、情報構造に合わせてイラストの `type` を選び、見た目の方向性として `style` を選ぶという二軸の考え方です。記事全体でビジュアルの一貫性を持たせたい場合、汎用的な Image Generation プロンプトよりも、`baoyu-article-illustrator` のほうが実務で使いやすくなります。

### どんな人に向いているか
この `baoyu-article-illustrator skill` は、ライター、ドキュメントチーム、インディー出版社、コンテンツマーケターに特に向いています。解説記事、チュートリアル、エッセイ、システム設計系のコンテンツを出す場面と相性がよく、1本の記事の中で複数の画像にそれぞれ別の役割が必要なケースに強みがあります。たとえば、ヒーローイメージ、フレームワーク図、比較ビジュアル、タイムライン、プロセスフローを使い分けたい場合です。

### 普通の画像プロンプトではなく選ばれる理由
最大の差は、意思決定を支援してくれる点です。リポジトリには `infographic`、`scene`、`flowchart`、`comparison`、`framework`、`timeline` の具体的な対応関係が用意されており、さらに `tech-explainer`、`tutorial`、`data-report` といった再利用しやすい preset もあります。加えて、スタイル参照とプロンプト構築ルールも整理されているため、整合性の取り方、参照の扱い、プロンプト整形で手探りになりにくいのが `baoyu-article-illustrator` の利点です。

### 導入前に知っておきたい大きな制約
Image Generation 向けの `baoyu-article-illustrator` は、すでに記事ドラフトや整理されたアウトラインがあるときに最も力を発揮します。1行で「いい感じに作って」と頼む用途の近道ではありません。前提となるのは、内容の分析、スタイル確認、プロンプト組み立てを含むワークフローです。記事構造と関係のない装飾画像を1枚だけ作りたいなら、通常の直接的な画像プロンプトのほうが速いこともあります。

## baoyu-article-illustrator skill の使い方

### インストール時にまず確認したい前提とファイル
`SKILL.md` 内には明示的な install コマンドがないため、通常は `JimLiu/baoyu-skills` リポジトリから自分の skills manager の運用で追加し、そのうえで次のファイルから読み始める形になります。
- `skills/baoyu-article-illustrator/SKILL.md`
- `prompts/system.md`
- `references/usage.md`
- `references/workflow.md`
- `references/prompt-construction.md`
- `references/style-presets.md`
- `references/styles.md`

初めて使う場合は、次も合わせて確認してください。
- `references/config/first-time-setup.md`
- `references/config/preferences-schema.md`

これらには、`EXTEND.md` を使った初回セットアップで詰まりやすいポイントがまとまっています。具体的には、watermark、preferred style、language、output preferences の設定です。

### baoyu-article-illustrator に必要な入力
`baoyu-article-illustrator` をうまく使うには、単なるトピックだけでは不十分です。最も機能しやすいのは、以下の情報があるときです。
- 記事ドラフト、アウトライン、または見出し構成
- 想定読者
- 公開文脈: blog、tutorial、report、newsletter
- 必要な画像数
- 実際にファイルとして持っている visual reference
- 任意の `type`、`style`、または `preset` の希望

弱い依頼の例:
- “Add images to my AI article.”

より良い依頼の例:
- “Illustrate this 1,800-word tutorial for startup engineers. I need 4 visuals: a hero image, one architecture diagram, one workflow image, and one comparison chart. Prefer clean technical visuals, low clutter, English labels, and a consistent blueprint-like feel.”

### ざっくりした要望を使えるプロンプトに変える方法
実用的な `baoyu-article-illustrator` ガイドとしては、最初に次の4点を明確にしておくのが有効です。
1. content unit: 記事全体か、特定セクションか
2. image jobs: explain、compare、summarize、narrate のどれか
3. visual system: `--type`、`--style`、`--preset`
4. constraints: language、watermark、output folder、references

例:
- 技術解説記事: `--preset tech-explainer`
- ステップ形式のチュートリアル: `--preset tutorial`
- プロダクト／プロセス記事: `--preset process-flow`
- 研究要約: `--preset science-paper`

合う preset がない場合は、直接組み合わせます。
- `--type framework --style blueprint`
- `--type comparison --style elegant`

まずは speed 重視で preset を使い、必要が出たら片方の軸だけ上書きするのがおすすめです。

### 出力品質を上げる workflow のコツ
このリポジトリの本当の価値は、構造化された進め方にあります。順番としては次の流れが堅実です。
1. `EXTEND.md` がなければ first-time setup を完了する
2. 記事を分析し、どこでビジュアルが本当に役立つかを見極める
3. 記事単位ではなく、各イラストごとに type/style を選ぶ
4. prompt files を丁寧に組み立てる
5. frontmatter の `references` には、実際に `references/` に存在するファイルだけを含める

特に最後の点は重要です。`references/prompt-construction.md` では、frontmatter に存在しないファイルパスを書くのはエラーだと明記されています。配色やスタイルを言葉で参考にしただけなら、存在しないファイルを装うのではなく、プロンプト本文で説明してください。

## baoyu-article-illustrator skill の FAQ

### baoyu-article-illustrator は通常の画像プロンプトより優れている？
記事制作のワークフローでは、たいてい Yes です。汎用プロンプトでも単発で良い画像は作れますが、`baoyu-article-illustrator` は「その記事にどんな種類の画像が必要か」を判断し、複数のビジュアル間でまとまりを保つのが得意です。解説記事、ドキュメント、長文コンテンツではこの差が効きます。

### 初心者でも使いやすい？
難易度は中程度です。考え方自体はわかりやすい一方で、記事の文脈を渡せること、複数ステップの流れに沿えることが前提になります。初心者なら、早い段階で独自の組み合わせを作り込むより、preset と `references/styles.md` にある基本の style 対応をそのまま使うほうが安全です。

### baoyu-article-illustrator skill が向かないケースは？
次のような用途なら、この `baoyu-article-illustrator skill` は見送ったほうがよいです。
- 記事構造と関係ない単発の装飾アート
- リポジトリ内の styles では足りない、強いブランド主導のイラスト演出
- 記事の各セクションを確認せずに即時出力したいケース
- prompting workflow ではなく、それ自体で完結する画像レンダリングエンジンを期待する場合

### 技術系・教育系コンテンツとの相性は良い？
はい。リポジトリは、技術解説、workflow、比較、アーキテクチャ図、教育用ビジュアルに特に強い構成です。`blueprint`、`scientific`、`notion`、`vector-illustration` の系統は、構造化された知識コンテンツにとくに使いやすい選択肢です。

## baoyu-article-illustrator skill を改善するには

### まずはコンテンツを視覚単位で分割する
最も効果が大きいのは、「記事全体に画像を付けて」と頼むのではなく、記事をビジュアル化すべき場面ごとに分けることです。たとえば次のようなセクションを明示します。
- concept explanation
- process flow
- side-by-side comparison
- architecture/framework view
- timeline or evolution

こうしておくと、type の選定もプロンプトの明瞭さも大きく改善します。

### baoyu-article-illustrator では style より先に type を決める
よくある失敗は、見た目の美しさに意識が寄りすぎることです。`baoyu-article-illustrator` では、`type` がその画像で本当に内容を伝えられるかを左右します。ステップ説明なら `flowchart`、トレードオフ比較なら `comparison`、システム整理なら `framework` を選び、`scene` は物語性が重要なときに限って使うのが基本です。そのうえで、トーンに合う style を重ねていきます。

### 参照情報と制約条件をより具体的に渡す
Image Generation 向けの `baoyu-article-illustrator` で結果を良くしたいなら、次の点を具体化してください。
- 読者の知識レベル
- 画像内ラベルの language
- 色の制限
- 画像内テキストを最小限にしたいか
- 一貫した aspect ratio や出力先
- 実ファイルとしての reference なのか、言葉による inspiration なのか

また、prompt construction のドキュメントでは、ファイルに裏付けられた reference と、言語的な style cue は別扱いだとはっきり書かれています。この違いはきちんと守るべきです。

### 最初の出力後は一度に1変数ずつ調整する
1回目の出力後は、同時に多くを変えず、1つの変数だけを調整して改善していくのが効果的です。
- style はそのままで、type を変える
- type はそのままで、style を変える
- 両方維持して、section summary を書き直す
- clutter を減らし、text density を下げる

多くのユーザーにとって最も良い改善ルートは、まず preset から始め、生成された prompt logic を確認し、その後 `references/styles/` の詳細な style files を使って詰める流れです。`baoyu-article-illustrator install` の価値が出てくるのはまさにここで、単にプロンプト作成が速くなるだけでなく、記事全体を通した再現性まで上げられます。