rico-resource-article

リソース推薦記事ジェネレーター

このスキルは、複数ターンの対話型ワークフローを通じて、高品質なリソース推薦記事を作成し、正確な内容、完全な構成、プロフェッショナルなスタイルを実現します。

主な機能

• インテリジェントな段階的生成：候補を収集 → ユーザーが確認 → タイトルを生成 → 記事を生成
• 分野への適応：トピックの分野（デザイン／開発／マーケティング／プロダクト／コンテンツ）を自動検出し、専門用語と文体を適用します
• 幅広い分野に対応：技術ツール、デザインリソース、開発フレームワーク、オンラインサービス、物理的な製品など
• 複数の生成モード：スマートな段階的生成、一括生成、アウトラインに基づく生成
• プロフェッショナルなフォーマット基準：完全なフロントマターと標準的な記事構成
• データの正確性：検証可能なデータのみを使用します（GitHub Stars、コンポーネント数、公式指標）

トリガー

このスキルには、次の2つのトリガーモードがあります。

モード1：明示的なコマンド（rico article プレフィックス）

• rico article [topic] / rico 文章 [主题]
• rico article 8 design tools / rico 文章 8个设计工具

モード2：自然言語（記事作成の意図が明示されている必要があります）

• 「shadcn/ui の推薦記事を生成して」
• 「ツールの推薦記事を書いて」
• 「リソース一覧の記事を作成して」

重要：このスキルは、ユーザーが記事の生成を明示的に希望している場合にのみトリガーされます。 「おすすめのツールを8個教えて」や「使いやすいツールはありますか」のような単純な質問ではトリガーしないでください。質問には直接回答してください。

例

トリガーされる例：

• rico article 8 React hooks libraries
• rico 文章 10个设计工具
• shadcn/ui の推薦記事を生成して
• Figma プラグインの推薦記事を書いて

トリガーされない例（質問または会話のみ）：

• 「コンポーネントライブラリを8個おすすめして」— 直接回答します
• 「何か良いツールはありますか？」— 会話形式の質問
• 「リソースを8個生成して」— 記事作成の意図が明確でない曖昧な依頼
• 「おすすめのプラグインは何ですか？」— 質問のみの問い合わせ
• 「生成 8 个资源」— 記事生成の意図が明確でない曖昧な依頼
• 「推荐几个好用的插件」— 質問のみで、記事は生成しません

---

🎯 モードの選択と優先順位

デフォルトモード：インテリジェントな段階的生成

モード選択の優先順位：

1. ユーザーがモードを明示的に指定している → 指定されたモードを使用します
2. ユーザーがアウトラインのリストを提示している → アウトラインに基づく生成を使用します
3. ユーザーがシンプルなリストだけを必要としている → クイック生成を使用します
4. デフォルトのフォールバック → インテリジェントな段階的生成を使用します

迷った場合は、常にインテリジェントな段階的生成を使用してください。ユーザーによる確認を通じて、記事の品質を最大限に高められます。

---

🌟 推奨モード：インテリジェントな段階的生成

これは、複数ターンの対話を通じて記事の品質を高める、最もスマートで制御しやすい生成モードです。

ワークフロー

User inputs topic and quantity
  ↓
Step 0: Domain Detection (Auto-detect topic domain)
  ↓
Step 1: Collect candidate items (URL + recommendation reason + differentiating features + verifiable data)
  ↓
User confirms candidate list
  ↓
Step 2: Generate 6 title options (pain-point, exploratory, recommendation)
  ↓
User selects title
  ↓
Step 3: Generate complete article with domain-specific writing style
  ↓
Step 4: Ask about screenshots (Optional - ALWAYS ask after article generation)

ステップ0：分野の検出

トピックの分野を自動検出し、対応する執筆テンプレートを適用します

検出ルール

分野	キーワード（EN/CN）	対象読者	注目領域
デザイン	Figma、Sketch、UI、UX、デザインシステム、コンポーネント、モックアップ、プロトタイプ、插件、设计、组件库、设计系统	デザイナー	創作効率、ビジュアル品質、デザイン規範、Design System、納品プロセス
開発	React、Vue、Angular、API、フレームワーク、ライブラリ、TypeScript、npm、框架、库、开发	開発者	技術スタック、パフォーマンス最適化、コード品質、GitHub Stars、コミュニティエコシステム
マーケティング	SEO、ROI、コンバージョン、A/Bテスト、分析、メールマーケティング、转化率、营销、分析	マーケター	ROI、データドリブン、コンバージョン効果、オーディエンスのセグメント化、自動化
プロダクト	プロトタイプ、ユーザーリサーチ、ロードマップ、コラボレーション、原型、用户调研、路线图	プロダクトマネージャー	機能の充実度、チームコラボレーション、ユーザー価値、意思決定支援
コンテンツ	執筆、CMS、公開、編集、写作、编辑、发布	コンテンツクリエイター	制作効率、コンテンツ品質、配信チャネル、AI 支援
一般	フォールバック	一般ユーザー	使いやすさ、機能の充実度、実用性

検出プロセス

1. Extract keywords from user topic
2. Match against domain keyword library
3. Calculate confidence score based on keyword matches
4. If confidence ≥80%: Auto-select domain and inform user
5. If confidence 50-79%: Ask user to confirm
6. If confidence <50%: Use General template

対話の例

信頼度が高い場合（自動選択）：

### User Input
"生成一篇 Figma 插件推荐文章，推荐 6 个"

### AI Response
🔍 **检测到领域: Design (设计领域)**

基于关键词 "Figma" + "插件"，将使用设计领域专业模板，侧重：
- ✅ 设计工作流集成
- ✅ 创意效率提升
- ✅ Design System 兼容性

[继续执行 Step 1: 收集候选项目...]

信頼度が中程度の場合（ユーザーに確認）：

### User Input
"生成一篇图片压缩工具推荐文章"

### AI Response
🤔 **检测到多个可能的领域方向**

"图片压缩工具" 可以是：
- A. 面向设计师（设计工作流、批量处理、保持质量）
- B. 面向开发者（API 集成、自动化处理、性能优化）

请问您希望侧重哪个方向？(回复 A 或 B，或直接跳过使用通用模板)

---

ステップ 1：候補項目を収集する

ユーザーのトピック要件に基づいて、該当するプロジェクト／ウェブサイト／ツールを収集し、以下の形式で一覧表示します。

候補リストの形式：

**1. [Project Name]**
- URL: {{website link}}
- Recommendation reason: {{2-3 sentences explaining why it's worth recommending}}
- Differentiating features: {{How it differs from similar projects}}
- Data: {{Verifiable metrics - GitHub Stars, component counts, official numbers}}

**2. [Project Name]**
...

⚠️ データの正確性に関するルール（重要）：

1. 検証可能なデータのみを使用する

• ✅ 使用する：GitHub のスター数、GitHub のフォーク数、NPM の週間ダウンロード数、コンポーネント／テンプレートの数（公式サイトから取得）
• ✅ 使用する：コントリビューター数、最終更新日、ライセンスの種類、技術スタックの詳細
• ❌ 使用しない：ユーザー数、顧客数、効率化率、架空の指標
• ❌ 使用しない：「100 万人以上のユーザー」「効率が 10 倍向上」「コンバージョン率が 25％向上」（公式に検証されている場合を除く）

2. データの収集方法

• GitHub ページにアクセスし、スター数、フォーク数、コントリビューター数、最終更新日を確認する
• 公式サイトにアクセスし、コンポーネント／テンプレートの数や機能一覧を確認する
• NPM ページにアクセスし、週間／月間のダウンロード数を確認する
• データが不確かな場合は、省略するか「概算」と明記する

⚠️ 重要なルール（必ず守ること）：

1. プロジェクトや URL を絶対に捏造しない

• ❌ プロジェクト名、URL、ウェブサイトを発明したり、捏造したりしない
• ❌ 架空のリソースやツールを作成しない
• ✅ 実在し、検証可能なプロジェクトのみを推奨する
• ✅ プロジェクトの実在性が不確かな場合は、候補から外すかユーザーに尋ねる

2. 掲載前に URL を確認する

• ✅ URL にアクセスでき、有効であることを確認する
• ✅ URL が疑わしい、またはリンク切れのように見える場合は、ユーザーに確認を促す
• ❌ リンク切れや信頼性に疑いのある URL のプロジェクトは掲載しない

重要：次の状況に該当する場合は、必ず先にユーザーに尋ねてください。

• トピックの方向性が不明確
• 候補項目が不足している（見つかった件数を伝える）
• 関連するサブトピックが複数見つかり、焦点を確認する必要がある
• 特定のプロジェクトの URL を確認する必要がある
• 実在し、検証可能な候補を十分に見つけられない（その旨を伝え、指示を仰ぐ）

候補を一覧表示した後は、必ずユーザーの確認を待ち、次のように伝えます。

Above are {{number}} candidate items. Please confirm:
1. Do you need to adjust any items?
2. Do you need to add or remove any items?
3. Reply 'y' or 'yes' to confirm and proceed

ステップ 2：タイトル候補を生成する

ユーザーが候補リストを確認した後、これらの項目に基づいて、異なるスタイルの記事タイトルを 6 つ生成します。

### Please select your preferred title style:

**A. Pain-Point Type**
- A1. {{title}}
- A2. {{title}}

**B. Exploratory Type**
- B1. {{title}}
- B2. {{title}}

**C. Recommendation Type**
- C1. {{title}}
- C2. {{title}}

Please tell me which title you choose (e.g., A1), or suggest modifications.

タイトルのスタイル例：

• 課題提起型：画一化にノーを！、ボトルネックを突破！、XXX に別れを告げよう
• 探索型：インスピレーションを探る！、徹底分析！、XXX を探る
• おすすめ型：厳選、必携、知っておきたい、XXX を作ろう、XXX の必需品

ステップ 3：記事全文を生成する

ユーザーがタイトルを選んだ後、記事全文を生成します。

まず、記事フォルダーのパスを決定します。

1. 中国語のタイトルを、内容が分かる英語のスラッグに翻訳する
2. 小文字とハイフン区切りの形式を使用する
3. ユーザーに「記事の保存先：{{article-slug}}/index.md」と伝える
4. スクリーンショットを使用する場合は、同じフォルダーに保存する

例：

Title: 精选 4 款最受欢迎的渐变生成器，每个设计师都值得收藏
Slug: featured-4-most-popular-gradient-generators
Path: featured-4-most-popular-gradient-generators/index.md

その後、記事のコンテンツを生成します。

記事の構成基準

ファイル構成

記事ファイルは、次の構成に従ってください。

{{article-slug}}/
└── index.md          # Article content
├── screenshot-1.png   # Screenshots (if any)
├── screenshot-2.png
└── ...

パスの説明：

• 記事は現在の作業ディレクトリに保存する
• フォルダー名：{{article-slug}}/（例：featured-4-most-popular-gradient-generators/）
• 記事ファイル：常に index.md
• スクリーンショット：記事と同じフォルダーに保存する

カバー画像の場所（記事フォルダーとは別）：

assets/blog/
└── cover-{{article-slug}}.jpg  # Manually added cover images

命名規則：

• 記事フォルダー：小文字の英語をハイフンで区切り、内容が分かる簡潔な名前にする
  • 例：shadcn-ui-component-libraries/、featured-4-most-popular-gradient-generators/
  • ルール：中国語のタイトルを英語に翻訳し、小文字にしてハイフンでつなぐ
  • 形式：[形容詞]-[数字]-[カテゴリ]-[項目]、または同様に内容が分かる形式
  • 例：
    • 「厳選！最も人気のあるグラデーションジェネレーター 4 選」→ featured-4-most-popular-gradient-generators/
    • 「デザイナー必携の Figma プラグイン 8 選」→ essential-8-figma-plugins-for-designers/
    • 「2026 年のおすすめ Vue コンポーネントライブラリ」→ best-vue-component-libraries-2026/
• ファイル：常に index.md
• スクリーンショット：記事と同じフォルダーに保存し、プロジェクト名を付ける（例：cssgradient-io.png）

1. フロントマター（メタデータ）

---
title: {{user selected title}}
publishDate: {{today's date: YYYY-MM-DD}}
read: {{estimated reading time in minutes, typically 6-12}}
description: {{English subtitle, concise summary for SEO}}
tags:
  - {{English tag1}}
  - {{English tag2}}
  - {{Chinese tag1}}
  - {{Chinese tag2}}
img: "/assets/blog/cover-{{article-slug}}.jpg"
img_alt: "{{Chinese description of cover image}}"
---

重要事項：

• img と img_alt は手動で追加するカバー画像です（自動生成ではありません）
• 画像のパスは次の形式にしてください：/assets/blog/cover-{{article-slug}}.jpg
• description は英語で簡潔に記述し、SEOに適した内容にしてください
• read は推定読了時間を分単位で示します
• tags には中国語と英語のキーワードを含めてください（合計4〜6個）

2. 導入段落（3〜4段落）

• 段落1：業界の背景と現状を紹介します
• 段落2：テーマの核心的な価値と意義を説明します
• 段落3：記事で紹介する内容を提示します
• 段落4（任意）：これらのリソースをおすすめする理由を説明します

3. 本文

確定した各項目について、次の形式で記述します。

### {{number}}. {{Project Name}}

- **官网**: [{{URL}}]({{URL}})
- **简介**: {{Core positioning, main functions, problems solved}}, covering {{specific content scope}}, {{special features/characteristics}}.
- **优势**: {{Why it's worth recommending, unique value, applicable scenarios, problems solved}}.

本文の要件：

• おすすめする項目数：ユーザーの要望に応じ、通常は6〜12個
• 論理的な順序で並べます（基本から応用へ、または一般的なものから専門的なものへ）
• 説明では、中心となる位置づけと主な内容の範囲を明確にします
• メリットでは、独自の価値と適した利用シーンを強調します
• 専門性を保ちつつ、対象読者に合わせて分かりやすく説明します

アグリゲーションプラットフォーム（該当する場合）：

アグリゲーションプラットフォームがある場合は、別に記載します。

Additionally, here are {{number}} aggregation platforms that collect {{platform purpose}}:

### {{number}}. {{Project Name}}
...

4. 結論（2つの要素）

• 小見出し（## レベル2の見出し）：テーマを掘り下げ、ありきたりな表現は避けます

  • 例：## Vibe Coding：デザインを「創造」そのものへと立ち返らせる
  • または：## コンポーネント化されたインスピレーション：創造性を核心に集中させる

• まとめの段落（3〜4段落）：

  • これらのリソースがもたらす全体的な価値を説明します
  • AIによる支援や自動化など、現在のトレンドと関連づけます
  • 活用方法を提案します
  • 読者に行動を促します

著者の署名は追加しないでください。

---

ステップ4：スクリーンショットについて尋ねる（記事生成後に必ず質問）

記事の生成が完了したら、必ずユーザーに尋ねてください：

✅ Article generated successfully! Saved to: `{{article-slug}}/index.md`

📸 Would you like to add screenshots for the recommended websites?

Quick Options:
- Type "n" or "no" - Skip screenshots
- Type "y" or "yes" - Use default service (ScreenshotOne)
- Type "u" or "urlscan" - Use urlscan.io (requires API key)

Default size: 1600×900 (16:9) - Best for blog articles

ユーザーが「no」または「n」と答えた場合： スキップしてワークフローを終了します。

ユーザーが「yes」または「y」と答えた場合： スクリーンショットの手順に進みます（下記の「📸 オプション：スクリーンショットの追加」を参照）。

ユーザーがカスタムサイズを希望する場合： 指定された寸法で進めます。

---

📌 その他の生成モード

モード1：ワンショット生成

ユーザーが希望を明確に把握しており、複数回の確認が不要な場合に使用します。

ワークフロー：

1. ユーザーのテーマを把握します
2. 候補となる項目を直接収集します
3. 注目を集めるタイトルを1つ生成します
4. 記事全体を生成します

記事の形式：上記と同じ（フロントマター＋導入＋本文＋結論）

モード2：アウトラインに基づく生成

ユーザーが候補リストをすでに提示している場合に使用します。

ワークフロー：

1. ユーザーが提示したアウトラインを確認します
2. 各項目の説明とメリットを記述します
3. タイトルを生成します
4. 記事全体を生成します

追加の対応：

• アウトラインにカテゴリタグ（例：3D、Animated、Minimal）が含まれている場合は、該当項目の「メリット」に反映します
• アウトラインにURLが含まれている場合は、リンクが有効か確認します
• アウトラインの内容に応じて項目数を調整します

モード3：クイック生成

導入、結論、フロントマターを省略し、おすすめリストのみを生成します。

### {{number}}. {{Project Name}}

- **官网**: [{{URL}}]({{URL}})
- **简介**: {{1-2 sentences}}
- **优势**: {{1-2 sentences}}

注： クイック生成モードでは画像を含めません。必要に応じて、ユーザーがスクリーンショットを手動で追加できます。

---

執筆スタイルの要件

1. 専門的：正確な用語を使い、論理を明確にします
2. 実践的：各おすすめ項目について、具体的な利用シーンと価値を示します
3. 読みやすい：段落の長さを適切に保ち、冗長な説明は避けます
4. 自然：AIによる文章にありがちな問題（過剰な並列表現、曖昧な説明、三部構成への固執、否定表現の並列、曖昧な出典）を避けます
5. 独自性：公式紹介文のコピーを避け、自分の言葉で言い換えます

よくある AI らしい文章の問題を避ける

問題 1：並列構造の多用

• ❌ 「効率性、柔軟性、拡張性があります。」
• ✅ 「効率的で柔軟性があり、簡単に拡張できます。」

問題 2：曖昧な説明

• ❌ 「このコンポーネントライブラリは非常に強力で、機能が豊富です。」
• ✅ 「200 以上のコンポーネントを収録し、フォーム、データ表示、ナビゲーションなど、さまざまな用途に対応します。」

問題 3：三つ組のパターン

• ❌ 「〜だけでなく、〜でもあり、さらに〜でもあります。」／「〜であっても、〜であっても、すべて〜」
• ✅ 自然で多様な文型を使ってください。

問題 4：否定表現の並列

• ❌ 「複雑な設定も、追加の依存関係も、学習コストも必要ありません。」
• ✅ 「設定は簡単で、依存関係はなく、すぐに使い始められます。」

問題 5：曖昧な出典

• ❌ 「多くの人が〜と考えています。」／「よく知られているように〜」
• ✅ 意見を直接述べるか、具体的なデータソースを提示してください。

---

特記事項

コンテンツのガイドライン

• タグには中国語と英語のキーワードを含め、4〜6 個にしてください。
• URL は正確で、クリックできるものにしてください。
• 誇張した宣伝を避け、客観性と専門性を保ってください。
• 著者の署名を追加しないでください。
• 画像は任意です。必要であれば、ユーザーが生成した記事にスクリーンショットを手動で追加できます。

⚠️ 安全性とコンプライアンスのルール（重要）

1. 禁止コンテンツ

• ❌ 海賊版、クラック版、または違法なソフトウェアやリソースを推奨しないでください。
• ❌ 著作権を侵害するコンテンツを宣伝しないでください。
• ❌ 利用規約に違反するリソースを推奨しないでください。
• ❌ アダルトコンテンツ、ギャンブル、または違法行為を含めないでください。
• ✅ 正当かつ合法で、倫理にかなうリソースのみを推奨してください。

2. 正確性の要件

• ❌ プロジェクト、URL、ウェブサイトを捏造しないでください。
• ❌ 架空のリソースやツールを作り出さないでください。
• ✅ 実在を確認できるプロジェクトのみを推奨してください。
• ✅ 実在する候補が十分にない場合は、その旨をユーザーに伝え、指示を仰いでください。

3. 検証

• ✅ 推奨するリソースが実在することを確認してください。
• ✅ URL にアクセスでき、安全であることを確認してください。
• ❌ 不審な URL やリンク切れの URL を、ユーザーへの注意なしに含めないでください。

4. 情報開示

• ✅ リソースの正当性が不確かな場合は、その旨を明記してください。
• ✅ ナレッジベースに該当するコンテンツがない場合は、正直にユーザーに伝えてください。
• ❌ リクエストに応えるために、推奨項目を捏造しないでください。

---

モード選択ガイド

ユーザーのニーズ	推奨モード	理由
「X 個を推薦して、記事も作成してください」	ステップごとのインテリジェント生成	ユーザーが確認に参加でき、品質を最大限に高められます
「XXX に関する推薦記事を作成してください」	ステップごとのインテリジェント生成	複数回のやり取りによって正確性が高まります
アウトラインのリストを提示している	アウトラインに基づく生成	内容が確認済みのため、すばやく完了できます
推薦リストだけが必要	クイック生成	簡潔で効率的です
テーマと数量が明確	ワンショット生成	すばやく出力できます

---

完全な例

ユーザー入力：

「shadcn/ui のコンポーネントライブラリに関する推薦記事を書いてください。8 個を推薦してください」

AI ステップ 1：候補項目を収集する

Here are 8 collected shadcn/ui component libraries:

**1. [Aceternity UI]**
- URL: https://ui.aceternity.com/
- Recommendation reason: Hottest component library in shadcn/ui ecosystem, 120k+ developers using it
- Differentiating features: Deeply integrated with Framer Motion, extensive visual effects components

**2. [Kibo UI]**
- URL: https://www.kibo-ui.com/
- Recommendation reason: Fills gaps in shadcn/ui's advanced components
- Differentiating features: Provides color picker, rich text editor and other advanced components

...

Above are 8 candidate items. Please confirm:
1. Do you need to adjust any items?
2. Do you need to add or remove any items?
3. Reply 'y' or 'yes' to confirm and proceed

ユーザー：y

AI ステップ 2：タイトル案を生成する

### Please select your preferred title style:

**A. Pain-Point Type**
- A1. Say No to Homogenization! 8 Curated Shadcn/UI Component Libraries
- A2. Break Through Design Bottlenecks! 8 Must-Try Shadcn/UI Extension Libraries

**B. Exploratory Type**
- B1. Inspiration Exploration! 8 Shadcn/UI-Focused Component Libraries
- B2. In-Depth Analysis: 8 Efficiency-Boosting Shadcn/UI Resources

**C. Recommendation Type**
- C1. 8 Shadcn/UI Component Libraries to Double Development Efficiency
- C2. Developer Essentials: 8 Quality Shadcn/UI Extension Libraries

Please tell me which title you choose (e.g., A1), or suggest modifications.

ユーザー：A1

AI ステップ 3：記事全体を生成する

ファイル構成：

content/shadcn-ui-component-libraries/
└── index.md

内容：

---
title: Say No to Homogenization! 8 Curated Shadcn/UI Component Libraries
publishDate: 2026-03-03
read: 8
description: Top 8 Awesome Shadcn UI Component Libraries
tags:
  - Shadcn UI
  - Component Libraries
  - UI组件库
  - 组件库推荐
img: "./cover-shadcn-ui.jpg"
img_alt: "8 Curated Shadcn/UI Component Libraries"
---

shadcn/ui is one of the hottest component systems today...

### 1. Aceternity UI

- **官网**: [https://ui.aceternity.com/](https://ui.aceternity.com/)
- **简介**: Hottest component library in shadcn/ui ecosystem with 120k+ developers, covering 200+ production-quality components...
- **优势**: Deeply integrated with Framer Motion and Tailwind CSS, providing glow cards, text gradients, 3D globe and other unique visual components...

...

---

📸 オプション：スクリーンショットを追加する

記事の生成後、推薦したウェブサイトのスクリーンショットを追加するかどうか、ユーザーに選択肢を提示します。

確認するタイミング

記事の生成が完了した後に確認します。

✅ Article generated successfully!

Would you like to add screenshots for the recommended websites?

Quick Options:
- Type "n" or "no" - Skip screenshots
- Type "y" or "yes" - Use default service (ScreenshotOne)
- Type "u" or "urlscan" - Use urlscan.io (requires API key)

Current default: ScreenshotOne (JPG format, smaller file size)
Default size: 1600×900 (16:9) - 适合博客文章

💡 **自定义截图尺寸 / Customize Screenshot Size:**
   Just mention it when requesting / 在请求时直接说明:
   - "Use 1920×1080" / "用 1920×1080 截图"
   - "Screenshot at 1440×900" / "截图尺寸 1440×900"

サービスの選択

ユーザーが「はい」（デフォルトを使用）を選ぶか、特定のサービスを選択した場合：

ユーザーが「はい」（デフォルトのサービス）を選択した場合：

Using default service: ScreenshotOne

✓ Fast (2-5 seconds per screenshot)
✓ 100 free screenshots/month
✗ Requires API key

ユーザーがサービスを比較したい場合：

Available screenshot services:

【ScreenshotOne】
✓ Fast (2-5 seconds)
✓ 100 free screenshots/month
✗ Requires API key

【urlscan.io】
✓ Free: 5,000 Public Scans/day
✓ Free: 1,000 Unlisted Scans/day  
✓ Free: 50 Private Scans/day
✗ Requires API key
✗ Slower than ScreenshotOne

Default: ScreenshotOne (configured in .env)

設定の確認

重要：ユーザーに尋ねる前に、必ず最初に .env ファイルを確認してください

ステップ 1：.env ファイルが存在し、API キーが設定されているか確認する

Check order:
1. .rico-skills/.env (project-level)
2. ~/.rico-skills/.env (user-level)

If API key found → Use it directly ✓
If not found → Go to Step 2

ステップ 2：API キーが設定されていない場合

Checking ScreenshotOne configuration...

⚠️ API Key not found in .env file

Get your free API key:
1. Visit: https://screenshotone.com/
2. Sign up (free, 2 minutes)
3. Copy your API Key

Choose how to configure:

[A] 💾 Create .env file (Recommended) - Key will be saved for future use
[B] 🔑 Enter API key now (One-time) - Key will only be used for this session
[C] ⏭️ Skip screenshots - Add manually later

Please reply A, B, or C:

ユーザーが [A]（.env ファイルを作成）を選択した場合：

Great! I'll create the .env file for you.

Please enter your API Key: [wait for user input]

✓ Creating .rico-skills/.env file...
✓ Saving API key...
✓ Configuration complete! Key saved for future use.

Now proceeding with screenshots...

ユーザーが [B]（今回のみ使用）を選択した場合：

Please enter your API Key (will be used for this session only): [wait for user input]

✓ Key received. Proceeding with screenshots...
(Note: You'll need to enter the key again next time)

ユーザーが [C]（スキップ）を選択した場合：

✓ Skipping screenshots. You can add them manually later.

Manual screenshot guide:
- Save screenshots to: say-goodbye-to-stock-photos-3-ai-image-generators/
- Recommended size: 1600×900 (16:9)
- Naming: {website-name}.png

urlscan.io の場合（同じ手順）：

Checking urlscan.io configuration...

⚠️ API Key not found in .env file

Get your free API key:
1. Visit: https://urlscan.io/user/ (login required)
2. Go to Settings → API Keys
3. Copy your API Key

Choose how to configure:

[A] 💾 Create .env file (Recommended) - Save for future use
[B] 🔑 Enter API key now (One-time) - Use for this session only
[C] ⏭️ Skip screenshots - Add manually later

Please reply A, B, or C:

.env に保存した後、確認メッセージを表示する：

✓ API key saved to .rico-skills/.env

Your configuration:
- Service: ScreenshotOne
- API Key: sk_•••••••••••••••• (hidden)
- Default size: 1600×900

This key will be automatically used for future screenshot requests.

スクリーンショットのサイズ

デフォルトのスクリーンショットサイズ：1600×900（16:9）

ブログや記事のレイアウトのほとんどに最適なサイズで、次の利点があります：

• ウェブサイトの詳細がはっきり見える
• レスポンシブデザインに適したアスペクト比
• ウェブで読み込む際に適切なファイルサイズ

スクリーンショットサイズのカスタマイズ：

異なるサイズが必要な場合は、スクリーンショットを依頼する際に指定してください：

Example requests:
- "使用 1920×1080 尺寸截图"
- "用 1440×900 截图"
- "截图尺寸设为 1200×800"
- "Take screenshots at 1920×1080"

利用可能なサイズ：

サイズ	アスペクト比	最適な用途
1920×1080	16:9	フル HD ディスプレイ
1600×900	16:9	デフォルト - ブログ記事
1440×900	16:10	Mac スタイルのディスプレイ
1200×800	3:2	タブレット、小型画面
1200×600	2:1	ワイドバナー
1200×900	4:3	従来型ディスプレイ

注： urlscan.io ではサイズの選択肢が限られています（通常は 1920×1080 または同等のサイズ）。カスタムサイズには、ScreenshotOne または手動のスクリーンショットツールを使用してください。

スクリーンショットの手順

設定が完了したら：

ScreenshotOne の場合：

Found 8 URLs to screenshot

[1/8] Capturing https://ui.aceternity.com/...
  Waiting for screenshot...
✓ aceternity-ui.png (2.3s)

[2/8] Capturing https://www.kibo-ui.com/...
✓ kibo-ui.png (1.8s)

...

✓ Screenshots completed: 8/8
Saved to: ./ (current directory)

urlscan.io の場合：

Found 8 URLs to screenshot

[1/8] Submitting scan for https://ui.aceternity.com/...
  Scan UUID: abc123-def456-ghi789
  Waiting for scan to complete...
  Downloading screenshot...
✓ aceternity-ui.png (8.2s)

[2/8] Submitting scan for https://www.kibo-ui.com/...
  Scan UUID: xyz789-uvw456-rst123
  Waiting for scan to complete...
  Downloading screenshot...
✓ kibo-ui.png (7.5s)

...

✓ Screenshots completed: 8/8
Saved to: ./ (current directory)

スクリーンショットを使って記事を更新する

スクリーンショットを保存した後、必ず記事を更新して画像を追加してください。

おすすめする各項目について、見出しの後にスクリーンショット画像を挿入します：

挿入前（スクリーンショットなし）：

### 1. Aceternity UI

- **官网**: [https://ui.aceternity.com/](https://ui.aceternity.com/)
- **简介**: ...

挿入後（スクリーンショットあり）：

### 1. Aceternity UI

![Aceternity UI](aceternity-ui.jpg)

- **官网**: [https://ui.aceternity.com/](https://ui.aceternity.com/)
- **简介**: ...

画像の挿入ルール：

1. 項目の見出し（### N. Project Name）の直後に画像を挿入する
2. 書式は ![Project Name](filename.jpg) を使用する
3. 代替テキストには、プロジェクト名または簡単な説明を使用する
4. 画像ファイルは index.md と同じディレクトリに置く

記事を更新した後、確認メッセージを表示する：

✓ Article updated with 3 screenshots

Updated sections:
- Section 1: meshgradients-com.jpg
- Section 2: csshero-mesher.jpg
- Section 3: nicepkg-mesh-gradient.jpg

スクリーンショットのファイル名

スクリーンショットは記事と同じディレクトリに保存されます：

shadcn-ui-component-libraries/
├── index.md              # Article content
├── aceternity-ui.png     # Screenshot 1
├── kibo-ui.png           # Screenshot 2
├── ...
└── footer-design.png     # Screenshot 8

命名規則： {project-name}.png

• ドメイン名またはプロジェクト名から抽出
• 小文字を使用し、単語はハイフンで区切る
• 例：aceternity-ui.png、kibo-ui.png

エラー処理

スクリーンショットの取得に失敗した場合：

⚠️ Some screenshots failed:
- kibo-ui.png: Timeout (30s)
- footer-design.png: API rate limit

✓ Successful: 6/8
❌ Failed: 2/8

You can manually add these screenshots later if needed.

手動でスクリーンショットを撮る方法

手動でのスクリーンショットを希望する場合や、API の利用上限に達した場合：

## Manual Screenshot Guide

### System Tools
- Mac: Cmd+Shift+4 (select area)
- Windows: Win+Shift+S (select area)

### Online Tools
- Screenshot.guru: https://screenshot.guru/
- Screenshot.rocks: https://screenshot.rocks/

### Recommended Dimensions
- Default: 16:9 (1600×900)
- Alternatives: 16:10, 3:2, 2:1, 4:3

### File Organization
Save screenshots in the same directory as the article:
- Article: `content/shadcn-ui-component-libraries/index.md`
- Screenshots: `content/shadcn-ui-component-libraries/*.png`

This keeps related files together and makes management easier.