# idea-reality-mcp-validation

The idea-reality-mcp-validation skill checks an idea for similar projects through an MCP tool, then returns competitors and trend signals. Use it before you start building.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 207 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/idea-reality-mcp-validation/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/idea-reality-mcp-validation

## What it does

The skill connects an agent to `idea_check`, which takes a plain-language idea and a search depth. `quick` checks GitHub and Hacker News; `deep` also searches npm, PyPI, Product Hunt, and Stack Overflow. Results can include a score, trend, similar projects, and suggestions for changing direction.

For Claude Code, install the skill with the command in the FAQ. The MCP server runs with `uvx idea-reality-mcp`. Setting `GITHUB_TOKEN` raises GitHub API rate limits, while `PRODUCTHUNT_TOKEN` enables Product Hunt in `deep` mode; without the relevant token, those extra capabilities are unavailable. The skill is also listed for Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/idea-reality-mcp-validation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/idea-reality-mcp-validation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/idea-reality-mcp-validation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/idea-reality-mcp-validation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/idea-reality-mcp-validation
```

2. **Manually: put the files in place**
- File: `.github/skills/idea-reality-mcp-validation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/idea-reality-mcp-validation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/idea-reality-mcp-validation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/idea-reality-mcp-validation/SKILL.md

## When to use it
- check whether similar projects exist before coding
- find competitors for a project idea
- inspect the trend around an idea
- see whether a planned feature is already common

## Example prompts
- Check whether projects like my idea for collaborative note editing already exist.
- Compare competitors for this project idea using the deeper search.
- See how common live collaboration is in Markdown editors.

## Similar
- [idea-reality-mcp](https://affpapa.org/en/nevibecode/mcp/idea-reality-mcp.md) — MCP server · ★ 832 repo stars
- [pp-company-goat](https://affpapa.org/en/nevibecode/skills/pp-company-goat.md) — skill · 806 installs
- [news-aggregator-skill](https://affpapa.org/en/nevibecode/skills/news-aggregator-skill.md) — skill · 6000 installs
- [project-idea-validator](https://affpapa.org/en/nevibecode/agents/voltagent-project-idea-validator.md) — subagent · ★ 6505 repo stars
- [ctx-upgrade](https://affpapa.org/en/nevibecode/skills/ctx-upgrade.md) — skill · 1700 installs
- [cyrus-setup-prerequisites](https://affpapa.org/en/nevibecode/skills/cyrus-setup-prerequisites.md) — skill · 1100 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
