[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-85111":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":16,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":37,"readmeContent":38,"aiSummary":10,"trendingCount":16,"starSnapshotCount":16,"syncStatus":14,"lastSyncTime":39,"discoverSource":40},85111,"vibe-check","TexasBedouin\u002Fvibe-check","TexasBedouin","By a 12-year product manager who builds 0-to-1: takes a beginner from a vague idea to a buildable plan, then guides the build (GitHub basics, clean-code habits, a verify-and-iterate loop, a checkup for the mess). For Claude Code, Codex, and Antigravity. grill-me is for engineers, vibe-check is for everyone else.","",null,"Shell",250,30,2,1,0,40.39,"MIT License",false,"master",true,[23,24,25,26,27,28,29,30,31,32,33,34,35,36],"ai-coding","antigravity","beginners","claude-code","claude-skill","codex","jobs-to-be-done","jtbd","no-code","outcome-driven-development","product-discovery","product-management","prompt-engineering","vibe-coding","2026-06-15 10:04:24","# vibe-check\n\nA skill for AI coding tools that guides complete beginners from a vague app idea to a buildable blueprint.\n\n**grill-me is for engineers. vibe-check is for everyone else.**\n\n## What it does\n\nWhen someone who's never coded before says \"I want to build an app that does X,\" this skill turns their AI tool into a patient mentor that:\n\n1. **Discovers what they actually need**: not features, but the real problem they're solving (Reddit pain-mining, a competitor gap analysis, and ODI opportunity scoring)\n2. **Maps the entire user experience**: happy flows, failure flows, and edge cases\n3. **Surfaces decisions they don't know they need to make**: auth, databases, payments, hosting, legal\n4. **Recommends a modern tech stack**: with plain-language explanations of what each piece does and why\n5. **Produces a complete plan document**: structured as the AI coding tool's onboarding manual, plus a **visual HTML blueprint** the human opens in their browser\n6. **Includes build checkpoints**: so the beginner is never lost during construction. The AI stops after each phase to explain what was just built, why, and what's next.\n7. **Teaches the build-time basics** in language for someone who has never touched code: local vs. GitHub vs. live, how to save and back up code (commit\u002Fpush\u002Fdeploy), and keeping secret keys safe.\n8. **Finds a growth loop**: how the app recruits its next user on its own, preferably viral and organic, built into the core flow rather than bolted on, so growth compounds instead of needing a constant push.\n9. **Handles marketplaces honestly**: when the idea is two-sided, it discovers *both* sides (not just the one the founder happens to be), and helps brainstorm a cold-start plan so the product doesn't launch into an empty room.\n10. **Keeps the app healthy as it grows**: a **Checkup Mode** that gently looks over a messy, grown codebase and tidies it safely, so the AI keeps building cleanly instead of breaking things.\n\n## Who it's for\n\n- People who have an app idea but have never built software\n- \"Vibe coders\" who can get something working on their screen but need help thinking through the full picture\n- Anyone who wants to go from idea → structured plan before touching code\n\n## How to use it\n\n### With Claude Code\n\nThe easiest way — installs via the open [skills CLI](https:\u002F\u002Fgithub.com\u002Fvercel-labs\u002Fskills), and works across agents:\n\n```bash\nnpx skills add TexasBedouin\u002Fvibe-check\n```\n\nOr clone it straight into your project:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FTexasBedouin\u002Fvibe-check .claude\u002Fskills\u002Fvibe-check\n```\n\nThen tell Claude:\n\n```\nUse the vibe-check skill to help me plan my app.\n```\n\nTo update later: run `npx skills update` if you installed via the CLI, or `git pull` inside `.claude\u002Fskills\u002Fvibe-check` if you cloned.\n\n### With other AI tools\n\nCopy the contents of `SKILL.md` into your AI tool's system prompt or project instructions.\n\n## What the skill produces\n\nBy the end of a vibe-check session, you'll have a plan document that includes:\n\n- **Problem statement**: in your own words\n- **User flows**: mermaid diagrams for happy path, failure path, and edge cases\n- **Feature breakdown**: V1 (build now) vs V2+ (build later)\n- **System architecture**: visual diagram with beginner-friendly labels\n- **Tech stack**: every tool, what it does, why it was chosen, what it costs\n- **Data model**: what gets stored, in plain language\n- **Cost breakdown**: monthly estimates with free tier details\n- **Pre-launch checklists**: security, legal, accessibility\n- **Growth loop**: the one way the app brings in its next user on its own, plus the number that proves it's working\n- **Build phases with checkpoints**: numbered phases with guided explanations at every step\n\nThis plan is designed to be handed directly to your AI coding tool to start building.\n\n## Example output\n\nWondering what a session actually looks like? Two complete examples in [examples\u002F](examples\u002F) — each walks the *entire* skill (discovery, ODI opportunity scoring, the five-lens gut-check, growth loops, the lot) and produces both deliverables: the markdown plan **and** a visual HTML blueprint.\n\n- **[A full ClearList session](examples\u002Fclearlist-session.md)** (+ [visual blueprint](https:\u002F\u002Ftexasbedouin.github.io\u002Fvibe-check\u002Fexamples\u002Fclearlist-blueprint.html)) — the complete back-and-forth from a one-line idea to the finished plan, including the Reddit reality-check. This is what running the skill *feels* like — and **ClearList is a real, live product that was built with vibe-check** ([clearlist.me](https:\u002F\u002Fclearlist.me)).\n- **[Idea → plan: a plant-care app](examples\u002Fplant-watering.md)** (+ [visual blueprint](https:\u002F\u002Ftexasbedouin.github.io\u002Fvibe-check\u002Fexamples\u002Fplant-blueprint.html)) — one sentence in (\"an app that reminds me to water my plants\"), a full buildable plan out.\n\n## Version\n\nCurrent version: **1.8.0** (see [VERSION](VERSION) and [CHANGELOG.md](CHANGELOG.md)).\n\nWhen you use vibe-check, it does a quick best-effort check for a newer version and tells you if you're behind. To update, run `git pull` inside `.claude\u002Fskills\u002Fvibe-check`. Versioning is semantic (MAJOR.MINOR.PATCH).\n\n## Who made this\n\nBuilt by Amer Arab. I spent 12-plus years as a product manager, most of it taking products from zero to one. Discovery is the part I care about most: working out whether a problem is real before anyone writes a line of code, then shaping something people actually want instead of something that merely works. Those years were also spent shoulder to shoulder with engineers, which is where the \"you're the PM, the AI is the engineer\" idea at the heart of this skill comes from. vibe-check is me handing a first-timer the instincts I had to learn the hard way.\n\n## Inspiration\n\n- [grill-me](https:\u002F\u002Fgithub.com\u002Fmattpocock\u002Fskills) by Matt Pocock: the relentless questioning energy\n- [improve-codebase-architecture](https:\u002F\u002Fgithub.com\u002Fmattpocock\u002Fskills\u002Ftree\u002Fmain\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture) by Matt Pocock: the deep-vs-shallow module wisdom and the visual HTML report, translated here into beginner metaphors (Checkup Mode + the navigability guidance)\n- [andrej-karpathy-skills](https:\u002F\u002Fgithub.com\u002Fmultica-ai\u002Fandrej-karpathy-skills) by multica-ai: the four \"how your AI should behave\" ground rules (think before coding, keep it simple, surgical changes, goal-driven), translated here for beginners\n- [autoresearch](https:\u002F\u002Fgithub.com\u002Fuditgoenka\u002Fautoresearch) by Udit Goenka: the verify-and-iterate loop (one change, check it, keep or revert, repeat), translated here as the beginner's supervised improvement loop\n- [\u002Foffice-hours](https:\u002F\u002Fgithub.com\u002Fgarrytan\u002Fgstack) by Garry Tan: the problem reframing and premise challenging\n- [The Design Sprint](https:\u002F\u002Fdesignsprintkit.withgoogle.com\u002F) by Jake Knapp \u002F Google Ventures: the future press release (vision extraction) and Crazy 8s, adapted here to Crazy 3s with sharing and voting\n- [User Story Mapping](https:\u002F\u002Fwww.jpattonassociates.com\u002Fuser-story-mapping\u002F) by Jeff Patton: walking the chosen journey step by step to surface the features each step requires\n- [Bob Moesta \u002F The Rewired Group](https:\u002F\u002Ftherewiredgroup.com\u002F) (Jobs to be Done): demand is born in the struggling moment, the demand-side lens behind the worst-moment question\n- [Tony Ulwick \u002F Strategyn](https:\u002F\u002Fstrategyn.com\u002F) (Outcome-Driven Innovation): the opportunity-scoring engine, and the competitor gap matrix used here as the beginner stand-in for ODI's satisfaction survey\n- [FrontierCode](https:\u002F\u002Fcognition.ai\u002F) by Cognition: quality over mere correctness, the fail-first test idea and the \"working is the floor, not the bar\" definition of done\n- [design-shotgun](https:\u002F\u002Fgithub.com\u002Fgarrytan\u002Fgstack) by Garry Tan \u002F gstack: the side-by-side comparison board, adapted here as plain static HTML\n- [Continuous Discovery Habits](https:\u002F\u002Fwww.producttalk.org\u002F) by Teresa Torres (opportunity solution trees): evidence-tagging opportunities, the framing-issues honesty pass, and the riskiest-assumption test\n- [Growth Loops](https:\u002F\u002Fwww.reforge.com\u002Fblog\u002Fgrowth-loops) by Brian Balfour \u002F Reforge (with Casey Winters and Kevin Kwok): the funnel-to-loop reframe and the loop taxonomy, translated here into three buildable shapes a beginner can act on (Phase 6.6)\n- [The Last Mile Playbook](https:\u002F\u002Fgithub.com\u002FTexasBedouin) by Amer Arab: the PM vs Engineer mindset, payment processor gotchas, and the hard-won lessons of shipping a real product as a non-developer\n\n## License\n\nMIT licensed. Use it however you want.\n","2026-06-15 02:30:02","CREATED_QUERY"]