Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses.

MITAuto-check passed

Install Mvp

skills CLI
$ npx skills add davepoon/buildwithclaude --skill mvp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davepoon/buildwithclaude mvp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/startup-superpowers/skills/mvp .claude/skills/mvp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mvp
GitHub stars
3.6k
Token cost
~1.3k tokens
SKILL.md length
638 words
Files
3 (incl. references)
Skills in repo
245
Repo updated
First seen
Licence
MIT

At a glance

Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses.

  • Works in 2 steps: Design conversation — structured… → Scaffold and deploy — optional Layer 2…
  • The founder wants to build something to test assumptions
  • SKILL.md covers Before you start, When no startup/mvp-plan.md…, When startup/mvp-plan.md exists and After saving startup/mvp-plan.md
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mvp is an agent skill from davepoon/buildwithclaude. Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses. Use when the founder wants to build something to test assumptions, discusses what to build next, wants to interpret results from a live MVP, or is deciding whether the current approach is still right. Also use when a founder proposes something to build — the skill will check whether the proposed form is the simplest thing that generates honest signal.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/initial-mvp-design.md` and `references/scaffold-and-deploy.md`).

The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • The founder wants to build something to test assumptions
  • Discusses what to build next
  • Wants to interpret results from a live MVP
  • Is deciding whether the current approach is still right

Example prompts

  • “Use the mvp skill to guide the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses”
  • “/mvp”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Design conversation — structured dialogue that produces startup/mvp-plan.md: what to build, why this form, which hypotheses it tests, and…
  2. Scaffold and deploy — optional Layer 2 reference that writes code to the project root and deploys using Vercel MCP, Supabase MCP, and the…

What it can do on your machine

Read from SKILL.md and the folder at commit 10bfc43. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mvp loads about 1.3k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 122 tokens; SKILL.md has 638 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~122
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

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.

SKILL.md

The full file from davepoon/buildwithclaude at commit 10bfc43, republished under its MIT licence (© davepoon). 638 words, ~1,289 tokens.

Download SKILL.mdSave it as .claude/skills/mvp/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
mvp
description
Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses. Use when the founder wants to build something to test assumptions, discusses what to build next, wants to interpret results from a live MVP, or is deciding whether the current approach is still right. Also use when a founder proposes something to build — the skill will check whether the proposed form is the simplest thing that generates honest signal.

MVP / Prototype

Help the founder figure out the simplest thing worth building to validate their remaining assumptions — and optionally scaffold and deploy it.

The central job of this skill is to be a principled counterweight to over-engineering. Most founders want to build more than they need to test what they don't yet know. This skill reads what's been validated, identifies the riskiest untested assumptions, and argues for the form of MVP that generates honest signal with the least build effort.

Two modes:

  1. Design conversation — structured dialogue that produces startup/mvp-plan.md: what to build, why this form, which hypotheses it tests, and what success looks like
  2. Scaffold and deploy — optional Layer 2 reference that writes code to the project root and deploys using Vercel MCP, Supabase MCP, and the v0 Platform API

Before you start

Read startup/core.md and scan startup/hypotheses/ to understand what's been established and what's still untested. Check startup/interviews/ and startup/surveys/ for evidence gathered so far. No directory scaffolding is needed — startup/ is created during project initialization.


When no startup/mvp-plan.md exists

Load the reference file that runs the design conversation:

.claude/skills/mvp/references/initial-mvp-design.md

The reference file's instructions take over from this point.


When startup/mvp-plan.md exists

Read it for context. Infer intent from the conversation — don't ask "what do you want to do?"

If the founder is discussing results or what they're seeing: Handle inline. Read the plan to understand what was built, what hypotheses were being tested, and what the success criteria were. Also check startup/interviews/ and startup/surveys/ for any evidence collected since the MVP launched — this context informs the assessment. Ask what they're seeing — numbers, anecdotes, surprises. Compare against the success criteria and give a frank read:

  • Confirmed — signal clearly supports the hypothesis; route updates through the hypotheses skill
  • Contradicted — signal clearly runs against it; route updates through the hypotheses skill
  • Inconclusive — make the distinction explicit: "the hypothesis is probably wrong" is different from "the experiment didn't reach the right audience or ran too short." The first warrants invalidating the hypothesis; the second warrants redesigning the experiment, not changing hypothesis state.

Update the ## Experiments Log in mvp-plan.md with what was learned (dated entry). If the plan needs to evolve, propose changes and get confirmation before writing back.

If the founder wants to iterate or pivot the experiment: Discuss what's changed. Propose what the next experiment should look like. Before overwriting the plan, move the current success criteria and outcome into the ## Experiments Log as a completed entry. Then update ## What We're Building, ## Why This Form, ## Hypotheses Being Tested, ## Success Criteria, and ## Distribution Plan with the new experiment. Propose the full updated content before writing. Get confirmation.

Show full SKILL.md (203 more words)Show less

If the founder wants to scaffold and deploy:

  • status: ready and a deployable form (landing page, demo, simple app) → load:
    .claude/skills/mvp/references/scaffold-and-deploy.md
  • status: designing → suggest finishing the design conversation first; offer to continue it
  • status: live → ask whether they want to redeploy or add something new; if yes, load the scaffold reference

If a founder proposes building something without a prior design conversation: Read the existing hypotheses. Brief honest check (2–3 sentences): is the proposed form the simplest thing that would test the riskiest untested assumptions? Share the assessment before proceeding — not a gate, just an informed nudge.

If the founder wants to archive: Archiving marks this MVP track as closed — the plan remains for reference but is no longer the active experiment. Read the file. Set status: archived, last_updated: today. Add a final log entry summarising the experiment outcome. Propose changes, get confirmation, write back.


After saving startup/mvp-plan.md

Briefly confirm: "Saved to startup/mvp-plan.md."

Mention natural next steps without pushing:

  • status: ready and deployable form → "Ready to scaffold and deploy — just say the word"
  • status: live → "When you have results, come back and we'll assess them against the success criteria"
  • Running interviews or surveys in parallel often produces richer validation than the MVP alone

© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/startup-superpowers/skills/mvp of davepoon/buildwithclaude.

  • SKILL.md
  • references/initial-mvp-design.md
  • references/scaffold-and-deploy.md

Open the folder on GitHubat commit 10bfc43

Compare with similar skills

Mvp 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.

Mvp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mvp this skilldavepoon/buildwithclaude3.6k—~1.3kAutomated safety check: PassMIT
Idea Refinementaddyosmani/agent-skills103k6 repos~2kAutomated safety check: PassMIT
HTML PPT Studiolewislulu/html-ppt-skill8.6k4 repos~4.7kAutomated safety check: PassMIT
Agent Browserquran/quran.com-frontend-next1.9k42 repos~3.3kAutomated safety check: PassNone
Process Inboxtelegramdesktop/tdesktop33k2 repos~4.5kAutomated safety check: PassGPL-3.0
Brag Launch Videolatent-spaces/brag14k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Idea Refinement

    addyosmani/agent-skills

    Guides a conversation that takes a vague idea through divergent and convergent thinking and ends in a markdown one-pager covering scope and assumptions.

    103k GitHub starsUsed in 6 repos~2k tokens
    Agent WorkflowsAuto-check passed
  • HTML PPT Studio

    lewislulu/html-ppt-skill

    Authors static HTML presentations from a library of themes, layouts and animations, with keyboard navigation, for talks, pitch decks and reports.

    8.6k GitHub starsUsed in 4 repos~4.7k tokens
    Documents & OfficeAuto-check passed
  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 42 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Process Inbox

    telegramdesktop/tdesktop

    Process the local ignored ai-tdesktop inbox into durable, independently testable Telegram Desktop task records while task execution worktrees remain active.

    33k GitHub starsUsed in 2 repos~4.5k tokens
    Productivity & AutomationAuto-check passed
  • Brag Launch Video

    latent-spaces/brag

    Turns the current project website or app into a short, shareable launch video with Hyperframes, planned from the project code with options for tone, format and voiceover.

    14k GitHub starsUsed in 1 repo~2.3k tokens
    Media & CreativeAuto-check passed
  • Perform Task

    telegramdesktop/tdesktop

    Resolve, start or resume, implement, review, test, and publish exactly one existing ai-tdesktop task by short slug or full dated id, including rare blocked retries and split-required results.

    33k GitHub starsUsed in 2 repos~3k tokens
    Productivity & AutomationAuto-check passed

More from davepoon/buildwithclaude

All 245 skills in this repo
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Hard Predict Future

    davepoon/buildwithclaude

    Activate this agent for any future-oriented question that requires deep quantitative analysis, historical precedents, and structured scenario planning.

    3.6k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated 2 days ago
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated 2 days ago
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Questions about Mvp

What does Mvp do?

Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses. Mvp is an agent skill from davepoon/buildwithclaude. Guides the founder through designing and optionally building the simplest MVP or prototype that validates their current hypotheses.

When should I use Mvp?

Mvp fits situations like: the founder wants to build something to test assumptions; discusses what to build next; wants to interpret results from a live MVP; is deciding whether the current approach is still right.

How do I install Mvp in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill mvp -a claude-code`. Or copy the skill folder (plugins/startup-superpowers/skills/mvp in davepoon/buildwithclaude) into .claude/skills/mvp in your project. Claude Code loads it when a task matches its description.

How do I install Mvp in Codex?

Run `npx skills add davepoon/buildwithclaude --skill mvp -a codex`. Or copy the skill folder (plugins/startup-superpowers/skills/mvp in davepoon/buildwithclaude) into .agents/skills/mvp in your project. Codex loads it when a task matches its description.

Can I use Mvp 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 davepoon/buildwithclaude --skill mvp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mvp, .gemini/skills/mvp, .github/skills/mvp and .opencode/skills/mvp in your project.

What does Mvp need to run?

SKILL.md names no scripts, command-line tools or credentials: Mvp is instructions for the agent only.

Does Mvp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mvp 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 Mvp use?

Mvp 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 Mvp use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.7k tokens, read only when the agent opens those files.

What are the alternatives to Mvp?

Skills that share tags, products or a category with Mvp: Idea Refinement (addyosmani/agent-skills, 103k stars), HTML PPT Studio (lewislulu/html-ppt-skill, 8.6k stars), Agent Browser (quran/quran.com-frontend-next, 1.9k stars) and Process Inbox (telegramdesktop/tdesktop, 33k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mvp?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,604 GitHub stars. The repository holds 245 skills in this directory. The repository was last updated on October 6, 2026.

Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.