project-idea-validator

プロジェクトアイデア検証 — 作る前に既存のものを確認しましょう

TinyFish CLI（tinyfish）を利用できます。これは、自然言語の目標を使ってターミナルからブラウザー操作を実行するツールです。このスキルでは、GitHub と Dev.to を並行して検索し、結果を統合してギャップ分析レポートを作成します。

実行前の確認（必須）

TinyFish を呼び出す前に、必ず両方の確認を実行してください。

1. CLI がインストールされていますか？

PowerShell：

Get-Command tinyfish; tinyfish --version

bash/zsh：

which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_INSTALLED"

インストールされていない場合は、そこで停止してユーザーに伝えてください。

TinyFish CLI をインストールしてください：npm install -g @tiny-fish/cli

2. 認証されていますか？

tinyfish auth status

認証されていない場合は、そこで停止してユーザーに伝えてください。

TinyFish API キーが必要です。こちらから取得してください：https://agent.tinyfish.ai/api-keys

次に、認証してください。

オプション 1 — CLI ログイン（対話形式）：

tinyfish auth login

オプション 2 — PowerShell（現在のセッションのみ）：

$env:TINYFISH_API_KEY="your_api_key_here"

オプション 3 — PowerShell（セッションをまたいで保持）：

[System.Environment]::SetEnvironmentVariable("TINYFISH_API_KEY", "your_api_key_here", "User")

反映するには、PowerShell を閉じてから再度開いてください。

オプション 4 — bash/zsh（Mac/Linux）：

export TINYFISH_API_KEY="your_api_key_here"

オプション 5 — Claude Code の設定： ~/.claude/settings.local.json に追加してください。

{
  "env": {
    "TINYFISH_API_KEY": "your_api_key_here"
  }
}

両方の確認に合格するまで、先に進まないでください。

---

このスキルでできること

プロジェクトのアイデア（例：「Figma デザインを Tailwind コンポーネントに変換する CLI ツール」）を受け取ると、このスキルは次の処理を行います。

1. 目的、技術スタック、またはキーワードが似ている既存のリポジトリを GitHub で検索します
2. 同じ課題を扱う記事、チュートリアル、またはプロジェクト紹介を Dev.to で検索します

その後、調査結果を構造化されたギャップ分析にまとめます。既存のもの、その成熟度、そしてまだ機会が残っている分野を明らかにします。

---

基本コマンド

tinyfish agent run --url <url> "<goal>"

フラグ

フラグ	用途
--url <url>	対象ウェブサイトの URL
--sync	結果がすべてそろうまで待機します（ストリーミングなし）
--async	送信してすぐに戻ります
--pretty	人が読みやすい形式で出力します

---

手順ごとのワークフロー

手順 1 — GitHub を検索する

アイデアに一致する既存のリポジトリを検索します。統合の前に一覧全体が必要なため、--sync を指定して実行してください。

tinyfish agent run --sync --url "https://github.com/search?q=<keywords>&type=repositories&s=stars&o=desc" \
  "Extract the top 10 search results as JSON: [{\"name\": str, \"owner\": str, \"description\": str, \"stars\": str, \"url\": str, \"last_updated\": str}]"

Figma から Tailwind への CLI のアイデアの例：

tinyfish agent run --sync \
  --url "https://github.com/search?q=figma+tailwind+cli&type=repositories&s=stars&o=desc" \
  "Extract the top 10 repositories as JSON: [{\"name\": str, \"owner\": str, \"description\": str, \"stars\": str, \"url\": str, \"last_updated\": str}]"

---

手順 2 — Dev.to を検索する

同じ課題領域を扱う記事やプロジェクトの投稿を検索します。手順 1 の結果処理と並行して実行してください。

tinyfish agent run --sync --url "https://dev.to/search?q=<keywords>" \
  "Extract the top 10 articles as JSON: [{\"title\": str, \"author\": str, \"tags\": [str], \"published_at\": str, \"url\": str, \"reactions\": str}]"

例：

tinyfish agent run --sync \
  --url "https://dev.to/search?q=figma+tailwind+component+generator" \
  "Extract the top 10 articles as JSON: [{\"title\": str, \"author\": str, \"tags\": [str], \"published_at\": str, \"url\": str, \"reactions\": str}]"

---

並列実行

手順 1 と 2 は互いに独立しています。同時に実行してください。Dev.to の検索を始める前に GitHub の検索結果を待たないでください。

推奨 — 並列呼び出し：

# Fire both simultaneously
tinyfish agent run --sync --url "https://github.com/search?q=<keywords>&type=repositories&s=stars&o=desc" \
  "Extract top 10 repositories as JSON: [{\"name\": str, \"owner\": str, \"description\": str, \"stars\": str, \"url\": str, \"last_updated\": str}]" &

tinyfish agent run --sync --url "https://dev.to/search?q=<keywords>" \
  "Extract top 10 articles as JSON: [{\"title\": str, \"author\": str, \"url\": str, \"reactions\": str}]" &

wait

非推奨 — 順次呼び出し：

# Don't do this — wastes time and gives the same results
tinyfish agent run --url "https://github.com/..." "...also search Dev.to..."

各ソースはそれぞれ個別に呼び出します。必ずそのようにしてください。

---

手順 3 — ギャップ分析にまとめる

両方のソースから結果が返されたら、調査結果を次の構成にまとめます。

## Project Idea Validation: <idea title>

### What Already Exists
- <project/article> — <what it does, stars/reactions, last active>
- ...

### Maturity Assessment
- GitHub: <active / abandoned / fragmented>
- Dev.to coverage: <heavy / moderate / sparse>

### Gaps & Opportunities
- <specific gap #1>
- <specific gap #2>
- ...

### Verdict
<1–2 sentences: is the space crowded, open, or ripe for a better take?>

両方のソースから得た生の JSON を入力として使用してください。リポジトリ名、スター数、記事タイトルを捏造せず、TinyFish が返した情報のみを使用してください。

---

キーワード戦略

検索結果の質は検索語に大きく左右されます。実行前に、アイデアから 2～3 個のキーワード候補を導き出してください。

アイデア	主なキーワード	キーワード候補
Figma から Tailwind への CLI	figma tailwind cli	figma css export、design token tailwind
AI コードレビュー Bot	ai code review github	llm pull request、automated code feedback
Markdown から Notion への同期	markdown notion sync	notion import cli、notion api markdown

最初の検索で結果が少ない場合は、キーワード候補ごとに別々の並列呼び出しを実行してください。

---

実行の管理

# List recent runs
tinyfish agent run list

# Get a specific run by ID
tinyfish agent run get <run_id>

# Cancel a running automation
tinyfish agent run cancel <run_id>

---

出力

CLI はデフォルトで data: {...} の SSE 行をストリーミングします。最終結果は type == "COMPLETE" かつ status == "COMPLETED" のイベントです。抽出されたデータは resultJson フィールドに格納されています。生の出力を直接読み取ってください。スクリプト側で解析する必要はありません。