idea-reality-mcp-validation — Claude Code skill for idea checks
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.
no license 207 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a claude-codeWhat idea-reality-mcp-validation 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.
What it helps with
- 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 for the agent
- 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.
How to install idea-reality-mcp-validation
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a claude-code2Manually: put the files in place
~/.claude/skills/idea-reality-mcp-validation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/idea-reality-mcp-validation/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a codex2Manually: put the files in place
.agents/skills/idea-reality-mcp-validation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a cursor2Manually: put the files in place
.cursor/skills/idea-reality-mcp-validation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/idea-reality-mcp-validation2Manually: put the files in place
.github/skills/idea-reality-mcp-validation/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/idea-reality-mcp-validationManually: put the files in place
.devin/skills/idea-reality-mcp-validation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about idea-reality-mcp-validation
How do I install idea-reality-mcp-validation in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill idea-reality-mcp-validation -a claude-code. The skill file is at ~/.claude/skills/idea-reality-mcp-validation/SKILL.md.
What does idea-reality-mcp-validation do?
It lets an agent check a project idea with the MCP tool idea_check. Results can show a score, trend, similar projects, and possible directions to explore.
What is the difference between quick and deep checks?
quick searches GitHub and Hacker News. deep adds npm, PyPI, Product Hunt, and Stack Overflow; Product Hunt requires PRODUCTHUNT_TOKEN to be enabled.