Agent skill

Mvp Scoping

by shawnpang in shawnpang/startup-founder-skills

When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.

MITAuto-check passedProduct & Project Management

Install Mvp Scoping

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill mvp-scoping -a claude-code

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

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills mvp-scoping --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/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mvp-scoping .claude/skills/mvp-scoping && 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-scoping
GitHub stars
343
Token cost
~1.8k tokens
SKILL.md length
1,030 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.

  • Works in 7 steps: State the hypothesis — Define what the… → List all candidate features — Enumerate… → Apply MoSCoW prioritization — Classify… → …
  • Needs to decide what to build
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mvp Scoping is an agent skill from shawnpang/startup-founder-skills. When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Needs to decide what to build
  • Defer for a first release
  • Minimum viable version of a product

Example prompts

  • “/mvp-scoping”

Workflow steps

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

  1. State the hypothesis — Define what the MVP is designed to learn or prove. Format: "We believe that [user segment] will [behavior] if we…
  2. List all candidate features — Enumerate every feature, capability, and requirement from the full vision.
  3. Apply MoSCoW prioritization — Classify every item as Must Have, Should Have, Could Have, or Won't Have (this time).
  4. Identify risks — For each Must Have, identify technical, market, and execution risks. Flag any Must Have that carries high risk and may…
  5. Define the cut line — Draw a clear boundary. Everything above the line ships in v1. Everything below has a specific trigger for when it…
  6. Estimate and validate — Rough-size the Must Haves. If they exceed the available timeline by more than 20%, force-rank the Must Haves and…
  7. Write the MVP spec — Produce a concise scope document with explicit inclusions, exclusions, and deferred items.

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. 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 Scoping loads about 1.8k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 1,030 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
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.

SKILL.md

The full file from shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,030 words, ~1,781 tokens.

Download SKILL.mdSave it as .claude/skills/mvp-scoping/SKILL.md (or your agent's skills folder).
name
mvp-scoping
description
When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.
related
prd-writing, roadmap-planning
reads
startup-context

MVP Scoping

When to Use

Activate when a founder or PM has an idea or a full feature spec and needs to distill it down to the smallest version worth building. Trigger phrases include "what's our MVP," "what should we cut," "scope this down," "what do we build first," "we only have 4 weeks," or "help me prioritize what to include." Also activate when a team is struggling with scope creep and needs to draw a clear line between must-have and nice-to-have.

Context Required

  • From startup-context: company stage, team size, runway/timeline pressure, existing product (if any), technical stack and constraints.
  • From the user: the full feature vision or spec, target user segment, the core hypothesis being tested, available timeline and resources, any non-negotiable requirements (compliance, security, contractual commitments).

Workflow

  1. State the hypothesis — Define what the MVP is designed to learn or prove. Format: "We believe that [user segment] will [behavior] if we provide [capability], and we'll know we're right when [measurable signal]."
  2. List all candidate features — Enumerate every feature, capability, and requirement from the full vision.
  3. Apply MoSCoW prioritization — Classify every item as Must Have, Should Have, Could Have, or Won't Have (this time).
  4. Identify risks — For each Must Have, identify technical, market, and execution risks. Flag any Must Have that carries high risk and may need a spike or prototype first.
  5. Define the cut line — Draw a clear boundary. Everything above the line ships in v1. Everything below has a specific trigger for when it gets built.
  6. Estimate and validate — Rough-size the Must Haves. If they exceed the available timeline by more than 20%, force-rank the Must Haves and demote the lowest.
  7. Write the MVP spec — Produce a concise scope document with explicit inclusions, exclusions, and deferred items.

Output Format

Hypothesis Statement

One sentence stating what the MVP will test and how success is measured.

MoSCoW Classification
Must Have (v1 — ships or the product fails)
FeatureRationaleRisk LevelEffort Estimate
Feature nameWhy this cannot be cutLow/Med/HighT-shirt size or days
Should Have (v1.1 — ships within 2-4 weeks after launch)

Same table format. These improve the product meaningfully but are not required for the core hypothesis test.

Could Have (v1.2+ — ships if data supports it)

Same table format. These are enhancements contingent on v1 learnings.

Won't Have (not this product/quarter)

List with brief reasoning for each exclusion.

Risk Register
RiskCategoryLikelihoodImpactMitigation
DescriptionTechnical/Market/ExecutionHigh/Med/LowHigh/Med/LowAction to reduce risk
MVP Scope Summary

Concise paragraph describing what v1 does, who it's for, and what it explicitly does not do.

Success Criteria

Specific metrics and thresholds that determine whether the MVP validated the hypothesis.

Frameworks & Best Practices

  • MoSCoW prioritization.
    • Must Have: Without this, the product does not work or the hypothesis cannot be tested. Apply ruthlessly. If more than 40% of features are Must Have, your bar is too low.
    • Should Have: Important but the product can launch without it. Users will notice the gap but can work around it.
    • Could Have: Nice-to-have. Include only if time permits with zero impact on Must Haves.
    • Won't Have: Explicitly out of scope this cycle. Naming these prevents scope creep.
  • The "cupcake, not a layer of cake" principle. An MVP is a complete, small experience — not an incomplete large one. A cupcake is a whole dessert. A cake layer with no frosting is an unfinished project.
  • Optimize for learning speed. The MVP's job is to test a hypothesis as fast as possible. Every feature should either be required for the test or removed.
  • Manual before automated. If a process can be done manually for the first 50 users, do not build automation for it in the MVP. Concierge MVPs and Wizard-of-Oz MVPs are valid.
  • One user segment. MVPs that try to serve multiple segments serve none well. Pick the segment with the strongest pain and the shortest sales cycle.
  • Hard conversation forcing function. If the team cannot agree on Must Haves, ask: "If we could only build 3 features, which 3 would we pick?" Start from zero and add, rather than starting from everything and cutting.
  • Deferred is not deleted. Maintain a deferred backlog with explicit triggers: "Build feature X when metric Y reaches threshold Z." This reassures stakeholders that their requests are heard.
  • Risk-first sequencing. Build the riskiest Must Have first. If it fails, you learn early and cheaply. If it works, everything else is lower risk.
  • Scope creep signals. Watch for: "while we're at it," "it would be easy to also," "users will expect," and "competitors have." Each phrase requires the response: "Does this change our hypothesis?"
Show full SKILL.md (263 more words)Show less
  • prd-writing — After scoping the MVP, write a PRD for the Must Have set.
  • roadmap-planning — Place Should Have and Could Have items into the roadmap's Next and Later horizons.
  • user-research-synthesis — Use customer insights to validate which features are truly Must Have vs. assumed Must Have.

Examples

Example 1: Scoping a new product MVP

User: "We're building a tool that helps freelancers send invoices, track time, manage expenses, handle taxes, and send contracts. We have 6 weeks and 2 engineers."

Good output excerpt:

Hypothesis: We believe freelancers earning $50K-$150K/year will send at least 3 invoices in their first month if we provide a simple invoice builder with payment tracking, and we'll know we're right when 40% of signups reach this threshold.

Must Have: Invoice creation, payment status tracking, email delivery. Should Have: Time tracking (linked to invoices), recurring invoices. Won't Have (this cycle): Expense management, tax calculations, contract management.

Rationale for cuts: Time tracking and expenses are adjacent workflows but not required to test the core invoicing hypothesis. Tax and contracts are separate products masquerading as features.

Example 2: Scoping down an existing feature

User: "Our PRD for the analytics dashboard has 15 chart types, custom date ranges, export to PDF/CSV, scheduled reports, and real-time data. Engineering says it's 3 months. We need it in 6 weeks."

Good output should classify the 15 chart types into 4-5 Must Have charts that cover 80% of use cases, defer scheduled reports and real-time data, keep CSV export but cut PDF, and identify that custom date ranges are Must Have because every user interview mentioned them.

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

Files

Just SKILL.md in skills/mvp-scoping of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

Mvp Scoping 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 Scoping compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mvp Scoping this skillshawnpang/startup-founder-skills343—~1.8kAutomated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Game Changing FeaturesopenstatusHQ/data-table-filters2.3k3 repos~2.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Convex Create Componentspokvulcan/poker-planning1148 repos~2.6kAutomated safety check: PassMIT
Self Improving Agentfarm-fe/farm5.6k2 repos~3.3kAutomated safety check: NotesMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Game Changing Features

    openstatusHQ/data-table-filters

    Find 10x product opportunities and high-leverage improvements.

    2.3k GitHub starsUsed in 3 repos~2.1k tokens
    Product & Project ManagementAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Convex Create Component

    spokvulcan/poker-planning

    Builds reusable Convex components with isolated tables and app-facing APIs.

    114 GitHub starsUsed in 8 repos~2.6k tokens
    Product & Project ManagementAuto-check passed
  • A universal self-improving agent that learns from ALL skill experiences.

    5.6k GitHub starsUsed in 2 repos~3.3k tokens
    Product & Project ManagementAuto-check: notes
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Mvp Scoping

What does Mvp Scoping do?

When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature. Mvp Scoping is an agent skill from shawnpang/startup-founder-skills. When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.

When should I use Mvp Scoping?

Mvp Scoping fits situations like: needs to decide what to build; defer for a first release; minimum viable version of a product.

How do I install Mvp Scoping in Claude Code?

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

How do I install Mvp Scoping in Codex?

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

Can I use Mvp Scoping 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 shawnpang/startup-founder-skills --skill mvp-scoping -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-scoping, .gemini/skills/mvp-scoping, .github/skills/mvp-scoping and .opencode/skills/mvp-scoping in your project.

What does Mvp Scoping need to run?

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

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

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

About 1.8k tokens (SKILL.md is roughly 7.1k 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 Mvp Scoping?

Skills that share tags, products or a category with Mvp Scoping: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Game Changing Features (openstatusHQ/data-table-filters, 2.3k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Convex Create Component (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mvp Scoping?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.