Researches any project idea against live data from GitHub and Dev.to to surface what already exists, how mature the space is, and where the real opportunity lives.
MITAuto-check passed
Install Project Idea Validator
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a claude-code
Project install by default; add -g for ~/.claude/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .claude/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .agents/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .cursor/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .gemini/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .github/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "project-idea-validator" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/project-idea-validator-skill into .opencode/skills/project-idea-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-idea-validator", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
project-idea-validator
GitHub stars
2.2k
Token cost
~1.8k tokens
SKILL.md length
508 words
Files
2
Skills in repo
28
Repo updated
First seen
Licence
MIT
At a glance
Researches any project idea against live data from GitHub and Dev.to to surface what already exists, how mature the space is, and where the real opportunity lives.
Works in 2 steps: Search GitHub → Search Dev.to
A developer describes something they want to build and wants to know if its been done before
SKILL.md covers Pre-flight Check (REQUIRED), What This Skill Does, Core Command and Step-by-Step Workflow, plus 5 more sections
Calls npm; reaches github.com and dev.to; needs TINYFISH_API_KEY
What it does
Project Idea Validator is an agent skill from tinyfish-io/tinyfish-cookbook. Researches any project idea against live data from GitHub and Dev.to to surface what already exists, how mature the space is, and where the real opportunity lives. Use when a developer describes something they want to build and wants to know if it's been done before. Triggers on phrases like "validate my idea", "has this been built", "is this already a thing", "what exists for X", "should I build this", "is this idea original", "check if my project exists", "what are the alternatives to what I want to build", "is…
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).
It works with GitHub, Bash and PowerShell. The repository describes itself as: A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build! The licence is MIT.
When your agent uses it
A developer describes something they want to build and wants to know if its been done before
Phrases like validate my idea
Has this been built
Is this already a thing
Example prompts
“s been done before. Triggers on phrases like”
“has this been built”
“is this already a thing”
“/project-idea-validator”
Requirements
Node.js
A credential in TINYFISH_API_KEY
Workflow steps
2 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 63cd841. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
github.com
dev.to
Also links to:
agent.tinyfish.ai
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
TINYFISH_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Project Idea Validator loads about 1.8k tokens when it runs. Until then it costs about 163 tokens; SKILL.md has 508 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~163
When it runs· the whole SKILL.md, loaded when a task matches
~1.8k
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
Download SKILL.mdSave it as .claude/skills/project-idea-validator/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
project-idea-validator
description
Researches any project idea against live data from GitHub and Dev.to to surface what already exists, how mature the space is, and where the real opportunity lives. Use when a developer describes something they want to build and wants to know if it's been done before. Triggers on phrases like "validate my idea", "has this been built", "is this already a thing", "what exists for X", "should I build this", "is this idea original", "check if my project exists", "what are the alternatives to what I want to build", "is the market saturated for X", or any request to research the competitive landscape before starting a project.
Project Idea Validator — Discover What Already Exists Before You Build
You have access to the TinyFish CLI (tinyfish), a tool that runs browser automations from the terminal using natural language goals. This skill uses it to search GitHub and Dev.to in parallel, then synthesizes results into a gap analysis report.
Pre-flight Check (REQUIRED)
Before making any TinyFish call, always run BOTH checks:
1. CLI installed?
PowerShell:
powershell
Get-Command tinyfish; tinyfish --version
bash/zsh:
bash
which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_INSTALLED"
If not installed, stop and tell the user:
Install the TinyFish CLI: npm install -g @tiny-fish/cli
Given a project idea (e.g. "a CLI tool that converts Figma designs to Tailwind components"), this skill:
Searches GitHub for existing repos with similar purpose, tech stack, or keywords
Searches Dev.to for articles, tutorials, or project showcases covering the same problem
It then synthesizes findings into a structured gap analysis: what exists, how mature it is, and where the opportunity still lives.
Core Command
bash
tinyfish agent run --url <url> "<goal>"
Flags
Flag
Purpose
--url <url>
Target website URL
--sync
Wait for full result (no streaming)
--async
Submit and return immediately
--pretty
Human-readable formatted output
Step-by-Step Workflow
Step 1 — Search GitHub
Search for existing repositories matching the idea. Run with --sync since you need the full list before synthesizing.
bash
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}]"
Example for a Figma-to-Tailwind CLI idea:
bash
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}]"
Step 2 — Search Dev.to
Search for articles and project posts covering the same problem space. Run in parallel with Step 1 results processing.
bash
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}]"
Example:
bash
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}]"
Show full SKILL.md (193 more words)Show less
Parallel Execution
Steps 1 and 2 are independent — run them at the same time. Do NOT wait for GitHub before starting Dev.to.
Good — Parallel calls:
bash
# 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
Bad — Sequential calls:
bash
# Don't do this — wastes time and gives the same results
tinyfish agent run --url "https://github.com/..." "...also search Dev.to..."
Each source is its own call. Always.
Step 3 — Synthesize Into a Gap Analysis
Once both sources return results, synthesize findings into this structure:
## 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?>
Use the raw JSON from both sources as input. Do not hallucinate repo names, star counts, or article titles — only use what TinyFish returned.
Keyword Strategy
The quality of results depends heavily on your search terms. Before running, derive 2–3 keyword variants from the idea:
Idea
Primary keywords
Variant keywords
Figma-to-Tailwind CLI
figma tailwind cli
figma css export, design token tailwind
AI code review bot
ai code review github
llm pull request, automated code feedback
Markdown-to-Notion sync
markdown notion sync
notion import cli, notion api markdown
Run separate parallel calls for each variant if the first pass returns sparse results.
Managing Runs
bash
# 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>
Output
The CLI streams data: {...} SSE lines by default. The final result is the event where type == "COMPLETE" and status == "COMPLETED" — the extracted data is in the resultJson field. Read the raw output directly; no script-side parsing is needed.
Project Idea Validator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
Project Idea Validator compared with similar skills
Skill
Stars
Used in
Tokens
Auto-check
Licence
Repo updated
Project Idea Validator this skilltinyfish-io/tinyfish-cookbook
Convert an academic paper PDF into a publish-ready, self-contained single-page project homepage (a self-contained index.html) — the kind of paper landing page researchers host on GitHub Pages.
Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in…
Reverse-engineer what a company is building by scraping their job postings, careers page, LinkedIn Jobs, and engineering blog using TinyFish web agents.
Check every dependency in a package.json against live CVE databases and security advisories in real time — specifically targeting vulnerabilities disclosed in the last 48 hours, the window that…
Researches any project idea against live data from GitHub and Dev.to to surface what already exists, how mature the space is, and where the real opportunity lives. Project Idea Validator is an agent skill from tinyfish-io/tinyfish-cookbook.to to surface what already exists, how mature the space is, and where the real opportunity lives.
When should I use Project Idea Validator?
Project Idea Validator fits situations like: A developer describes something they want to build and wants to know if its been done before; phrases like validate my idea; has this been built; is this already a thing.
How do I install Project Idea Validator in Claude Code?
Run `npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a claude-code`. Or copy the skill folder (skills/project-idea-validator-skill in tinyfish-io/tinyfish-cookbook) into .claude/skills/project-idea-validator in your project. Claude Code loads it when a task matches its description.
How do I install Project Idea Validator in Codex?
Run `npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a codex`. Or copy the skill folder (skills/project-idea-validator-skill in tinyfish-io/tinyfish-cookbook) into .agents/skills/project-idea-validator in your project. Codex loads it when a task matches its description.
Can I use Project Idea Validator in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tinyfish-io/tinyfish-cookbook --skill project-idea-validator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-idea-validator, .gemini/skills/project-idea-validator, .github/skills/project-idea-validator and .opencode/skills/project-idea-validator in your project.
What does Project Idea Validator need to run?
Going by SKILL.md and its folder, Project Idea Validator needs the command-line tools its instructions call (npm) and credentials named TINYFISH_API_KEY. Our summary lists: Node.js; A credential in TINYFISH_API_KEY.
Does Project Idea Validator access the network?
SKILL.md names 3 domains. In commands or code: github.com and dev.to; the agent is likely to contact these when it follows the instructions. As links in the text: agent.tinyfish.ai. This is read from the text; nothing was executed.
Is Project Idea Validator safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Project Idea Validator use?
Project Idea Validator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Project Idea Validator use?
About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Project Idea Validator?
Skills that share tags, products or a category with Project Idea Validator: CCPM Project Management (automazeio/ccpm, 8.4k stars), Windows App SDK Issue Triage Report (microsoft/WindowsAppSDK, 4.7k stars), Wizard (bestofjs/bestofjs, 3.1k stars) and Paper2html (QuZhan51496/paper2anything, 469 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Project Idea Validator?
tinyfish-io (a GitHub organization) maintains it in tinyfish-io/tinyfish-cookbook, which has 2,226 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 8, 2026.
Source: tinyfish-io/tinyfish-cookbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
