Clearbox Onboard

clearbox-onboard

One domain in, a full Clearbox offer pack out, every claim sourced.

The clearbox.to onboarding form asks for a name, a one-liner (80 chars max), and selling points, and warns: "Don't rush this one. Clearbox scores Reddit content against what you write here." This skill is the not-rushing. It researches the company first, then fills the form's exact shapes plus the fields behind the form (keywords, competitors, tracked subreddits). The stakes are structural: your keywords and competitors drive the matching, and the subreddit suggestion pass runs once at onboarding and is never re-run. Write these fields like they are permanent, because they mostly are. Output is pasted by the user into the form; there is no API path today.

Inputs

A website domain (e.g. acme.com); optionally any of: a knowledge brief, a codebase path, or the company's own-words description — whatever is supplied gets read first.

Before you write a word

Read FACTCHECK.md in this directory and hold every output to it. Short version: every selling point traces to a URL, "Unlike X" claims need a source on X too, never assume the category from the name, the user's brief is intent not fact, absence claims ("only X does...") are traps, and no invented subreddit or brand names.

The standard

The form's own example one-liner is the shape: "HubSpot is a CRM for B2B sales teams." The bar to clear: a stranger reads one sentence and knows what the product is, who uses it, and why it matters. Twenty-five words or fewer usually gets there; 80 characters is the hard limit.

Steps

1. Read what the user gave you

Brief, codebase, own-words description — read it all before researching, so you know the positioning intent.

Gotcha: user materials are authoritative on positioning intent, never on public claims. A claim the company makes about itself still needs to exist on their site (or somewhere public) before it enters a scored field. If it exists nowhere public, flag it: "publish this first or it stays out."

2. Research the company (never assume)

Fetch their website and web-search them. Confirm what they actually sell, who the buyer is, and who they actually compete with. In one reference build, a client looked like an "engines and generators" business from the name and turned out to be an outdoor power equipment dealer; the wrong assumption would have poisoned everything.

• Fetch: homepage, /pricing, /docs, /changelog or /blog (whichever exist).
• Search: "<name> alternatives", "<name> vs <competitor>", and the category head terms.
• Capture as you go: what they sell, who buys, competitor names, and the literal words buyers use for the problem — those words become the keywords.

3. Draft the one-liner

Hard limit 80 characters. Check it, don't eyeball it:

printf '%s' "<one-liner>" | wc -c

Shape: "X is a [category] for [who]". No adjective that doesn't narrow the category or the buyer.

4. Fill the selling-point slots

The form accepts points in seven fixed shapes. Use the shapes verbatim; write 5–8 points:

1. Unlike [competitor], X does [thing]
2. A unique feature of X is [feature]
3. X replaces [tool]
4. Only X does [thing], by [how]
5. X does [thing] better than [alternative]
6. Where [competitor] does [X], X does [Y]
7. X is the only [category] that does [thing]

Rules: every competitor named must have come out of step 2. A slot you can't source gets skipped, not faked — slots 4 and 7 assert category-wide absence and are the easiest to falsify (FACTCHECK rule 5: downgrade to slot 2 when unsure). Lead with the differentiation slots (1, 4, 6, 7); feature-breadth slots carry the tail.