Skip to main content
ClaudeWave
Skill188 repo starsupdated today

before-you-build

# ClaudeWave Editor Note **Before You Build** is a pre-implementation risk assessment skill that helps teams identify the dominant assumption blocking a product, feature, or integration before development begins. It applies a structured seven-dimension risk framework (demand, buyer, distribution, workflow, timing, trust, scope) to pinpoint the single most critical uncertainty, then recommends a minimal, low-cost validation step such as user interviews, payment requests, or manual delivery tests. Use this skill when facing questions about whether to build, how to scope, or what to validate first, rather than jumping directly into technical planning or code.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/OneWave-AI/claude-skills /tmp/before-you-build && cp -r /tmp/before-you-build/before-you-build ~/.claude/skills/before-you-build
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Before You Build

Use this skill as a short pre-build risk gate.

The goal is to stop implementation from starting before the riskiest product assumption is clear. Stay implementation-agnostic: do not recommend stacks, architectures, tools, or code.

## Core Behavior

When invoked:

1. Restate the idea in one sentence.
2. Identify the dominant pre-build risk.
3. Give a short risk verdict.
4. Recommend the smallest validation step that can reduce uncertainty before building.

Keep the response short unless the user explicitly asks for a deeper review.

## Seven Risk Dimensions

Check the idea through these dimensions:

- Demand risk: Do enough people already feel this problem strongly?
- Buyer risk: Is there a clear person or team with reason to pay or commit?
- Distribution risk: Is there a believable path to reaching those people?
- Workflow risk: Does the idea fit how users already behave, decide, or work?
- Timing risk: Is this urgent now, or only interesting in theory?
- Trust risk: Does the product require data, access, behavior change, or credibility users may not grant?
- Scope risk: Is the proposed build larger than the proof needed right now?

Pick the one or two risks that matter most. Do not turn every review into a long checklist.

## Output Format

Use this format:

```markdown
## Before You Build

Idea:
- [One-sentence restatement.]

Risk verdict:
- [Low / Medium / High risk] because [one concrete reason].

Main risk:
- [The dominant risk dimension and why it matters.]

Smallest validation step:
- [One specific action the user can take before building.]

Build guidance:
- [Build now / Build smaller / Validate first / Do not build yet.]
```

## Validation Step Rules

The smallest validation step should be specific and low-cost.

Prefer steps like:

- Talk to five target users who already tried to solve the problem.
- Ask for payment, pre-order, letter of intent, or manual commitment before building software.
- Run a landing page, waitlist, outbound message, or concierge test around one narrow promise.
- Manually deliver the outcome once before automating it.
- Test whether the missing feature blocks payment, retention, activation, or only completeness.
- Find one repeated channel that can reach the target users before expanding scope.

Avoid steps like:

- Build the MVP first.
- Add more features to see what happens.
- Choose a tech stack.
- Design the architecture.
- Write code.
- Create a broad product roadmap.

## Special Cases

If the idea is too vague, ask one clarification question:

```text
Who is this for, what painful situation are they in, and how do they solve it today?
```

If the user is asking about a feature for an existing product, focus on whether the feature is a real blocker for payment, retention, activation, trust, or delivery.

If the user says the project is for learning, portfolio, or fun, do not judge it by startup standards. Focus on keeping scope small and making the learning outcome clear.

If the decision to build is already made and the user only wants implementation help, do not use this skill.

## Style

Be direct, skeptical, and useful.

Do not be dismissive. The point is not to kill ideas; the point is to make the next build decision harder to fool yourself about.
accessibility-auditorSkill

Audit websites for accessibility issues and WCAG compliance. Use when checking accessibility, fixing a11y issues, or ensuring WCAG compliance.

agent-armySkill

Deploy a 2-layer parallel agent hierarchy for large, parallelizable work — big refactors, multi-file migrations, codebase-wide audits, bulk generation. Layer 1 is 3-50+ specialist agents, each with its own full context window; Layer 2 is 2+ sub-agents per member. Includes git safety, tiered sizing, a pre-deploy gate, phantom-completion checks, and multi-wave follow-up.

agent-swarm-deployerSkill

Deploys swarms of sub-agents for massive parallel data processing tasks. Unlike agent-army (which is for code changes), this is for DATA tasks -- processing 1000 documents, analyzing datasets, bulk content generation. Configurable swarm size, task distribution, result aggregation, progress tracking, and error recovery.

agent-team-builderSkill

Designs and deploys custom agent teams for specific business workflows. Interactive discovery of business processes, then generates complete team configurations with specialized agent roles, tool access, communication protocols, and handoff rules.

agent-to-agentSkill

Agent-to-Agent (A2A) communication protocol. Connect two or more Claude agents that pass messages, share context, delegate tasks, and collaborate. Implements structured handoffs, shared memory, and multi-agent conversations.

ai-readiness-assessmentSkill

Assesses how ready a business is for AI adoption across six dimensions. Evaluates data maturity, tech stack, team skills, process documentation, budget, and culture. Generates a comprehensive ai-readiness-report.md with scores, gap analysis, and recommended starting points. Aligned with OneWave AI's audit methodology.

animateSkill

Generate animated videos and motion graphics from natural language descriptions. Creates a standalone Vite + React project with Framer Motion scenes that auto-play in the browser. Use when the user wants to create animations, motion graphics, video intros, animated presentations, or product demos.

api-documentation-writerSkill

Generate comprehensive API documentation including endpoint descriptions, request/response examples, authentication guides, error codes, and SDKs. Creates OpenAPI/Swagger specs, REST API docs, and developer-friendly reference materials. Use when users need to document APIs, create technical references, or write developer documentation.