🎯

before-you-build

🎯Skill
wshobson/agents631 InstallsAdded Jun 26, 2026

Installation

$npx skills add wshobson/agents --skill before-you-build

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/before-you-build
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/before-you-build/
  • All projects ~/.claude/skills/before-you-build/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

Before You Build

Run a compact pre-mortem before implementation. The goal is not to block building; it is to identify the highest-risk assumption, the smallest validation step, and the build scope that should be delayed until evidence improves.

When To Use

Use this skill when a user asks to build or ship:

  • A new product, MVP, prototype, landing page, SaaS app, marketplace, content site, agent workflow, or internal tool
  • A major feature with unclear adoption, revenue, retention, trust, or distribution impact
  • A public launch asset where weak positioning could waste development or promotion effort

Skip this skill when the task is a narrow implementation fix, refactor, test repair, dependency update, or already-validated change with clear acceptance criteria.

Risk Checklist

Review the idea across these risks:

  • Demand: Is there evidence that a specific buyer or user urgently wants this?
  • Positioning: Can the target user understand what it is and why it matters in one sentence?
  • Monetization: Is there a credible path to payment, budget, or strategic value?
  • Retention: Is there a reason users would return after the first try?
  • Trust: Does the product require credibility, data access, integrations, or behavior change that users may resist?
  • Distribution: Is there a repeatable way to reach the target user?
  • Feature adoption: For feature work, will the feature change user behavior or just add surface area?

If the verdict is not obvious, use references/risk-checklist.md for deeper questions.

Output Format

Keep the response short and decision-oriented:

  1. Risk verdict: Low, medium, or high risk, with one sentence explaining why.
  2. Main assumption: The single assumption most likely to break the project.
  3. Evidence to find first: The smallest useful signal before building more.
  4. Do next: One concrete validation step or reduced build scope.
  5. Delay: What not to build yet.

Guidance

  • Be direct about weak evidence, but avoid dismissing the user's idea.
  • Prefer smaller validation steps over large research plans.
  • Separate product risk from engineering difficulty.
  • If the idea is already validated, say what evidence makes it lower risk and suggest the smallest implementation slice.
  • If facts are missing, name the missing evidence instead of inventing market claims.

More from this repository10

🎯
tailwind-design-system🎯Skill

Helps you build a consistent look for your app with Tailwind CSS v4. It sets up shared colors, sizes, dark mode and reusable components so every screen matches.

🎯
typescript-advanced-types🎯Skill

A guide to TypeScript's advanced type features, which describe the shape of your data so mistakes are caught before the code runs. It covers reusable types, types that change based on rules, and built-in helper types, with short examples.

🎯
nodejs-backend-patterns🎯Skill

Guidance for building reliable server-side apps with Node.js, using Express or Fastify. It covers login, error handling, databases, API design and a list of proven best practices.

πŸͺ
wshobson-agentsπŸͺMarketplace

Intelligent automation and multi-agent orchestration for Claude Code

πŸ”Œ
framework-migrationπŸ”ŒPlugin

Claude Code plugin for AI-powered framework migration workflows, coordinating specialized agents to plan and execute transitions between technology stacks as part of the wshobson/agents marketplace.

πŸ”Œ
payment-processingπŸ”ŒPlugin

A Claude Code plugin for payment system integration covering Stripe, PayPal, and billing platforms with checkout flows, subscription management, and webhook handling in the wshobson/agents ecosystem.

πŸ”Œ
developer-essentialsπŸ”ŒPlugin

A Claude Code plugin bundling core development tools and agents for everyday tasks like debugging and code generation, part of the wshobson/agents marketplace with 73 focused plugins.

πŸ”Œ
observability-monitoringπŸ”ŒPlugin

Claude Code plugin for observability and monitoring including logging, metrics, distributed tracing, and alerting, part of the wshobson/agents marketplace with 73 focused plugins.

πŸ”Œ
deployment-strategiesπŸ”ŒPlugin

A Claude Code plugin providing specialized AI agents for deployment strategy planning and execution, covering blue-green deployments, canary releases, rolling updates, and zero-downtime patterns.

πŸ”Œ
jvm-languagesπŸ”ŒPlugin

Claude Code plugin for JVM language development including Java, Kotlin, and Scala with specialized agents for idiomatic patterns, build tools, and runtime optimization in the wshobson/agents marketplace.