Index of every page on this site: llms.txt
All skills
wshobson avatar

/before-you-build

@4220308
by Seth Hobsonwshobson/agents43k stars
4,518
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/wshobson/agents/before-you-build

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈95 tokens for metadata: the name and description. ≈596 when used: this file. ≈403 more on demand in 1 file.

Description uses 4.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈382 characters, or 4.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts23d3 checks · Risk SAFE
  • Gen Agent Trust Hub25d

    This skill is a documentation-only tool used to guide an AI agent through a product risk assessment. It contains no code, executes no commands, and makes no network requests.

  • Socket23d

    No alerts

  • Snyk25d

    Risk: LOW · No issues

Signed by skilld at 4220308. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 5 months ago

README badge

README badge for wshobson/agents/before-you-build