agentleFS
link7373link7373/agentic-sales-marketing/.claude/skills/research-market/SKILL.md

research-market

Skill1 starsChanged 3 months agoMITView on GitHub

Research who the customer is, the smallest viable market to win first, customer language, competitors, and where the audience lives online. Run after setup and before offer/positioning work; rerun when entering a new segment.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/research-market — Know the Buyer Before Anything Else

Inputs: knowledge/business-context.md, open questions from setup. Agents: market-researcher leads. Method: knowledge/methods/positioning-and-audience.md (audience sections), knowledge/methods/digital-channel-strategy.md (channel research).

Steps

  1. Frame the questions. From business context, list what must be learned: who exactly buys, what words they use, what they compare us to, where they gather, what triggers purchase. Confirm scope with the operator only if the product itself is ambiguous.
  2. Draft candidate segments. 2–4 hypotheses for the smallest viable market — narrow enough that members recognize each other. For each: who, the burning problem, why we could be their obvious choice.
  3. Mine real language. For the strongest segments, collect verbatim customer phrases from reviews of competing products, community threads, marketplace Q&As, and forums. Tag phrases as problem / desired outcome / objection. This corpus feeds all future copy — collect generously.
  4. Map competitors. Direct, indirect, and "do nothing / DIY". For each: positioning, price, visible strengths, complaint patterns (their bad reviews are our opportunity list). Identify credible open space.
  5. Locate the audience. Rank channels by reachability for this budget: search terms and volumes where discoverable, marketplaces and their search behavior, communities, platforms. B2B: add ICP detail (industry/size/role/trigger events) and ethical list-building sources. B2C: add identity dimension of the purchase.
  6. Recommend the beachhead. One segment to win first, with rationale and the riskiest untested assumption. Present to the operator with the evidence trail; capture their business-knowledge reactions — they know things research can't find.
  7. Record. Profiles via templates/audience-profile.md.

Before you start

  1. Required inputs: knowledge/business-context.md at status seeded or better — if stub, offer to run /setup-team first.
  2. Scan knowledge/decision-log.md for tags audience, channel — honor prior segment decisions or explicitly supersede them with new evidence.
  3. Gate check: none — research is internal. Web research uses read-only tools (WebSearch, Bright Data search/scrape, Similarweb if authorized).

If things go wrong

  • Web research tools unavailable/unauthorized → use WebSearch/WebFetch; note in the output which findings are thinner as a result.
  • Too little public signal to validate any segment → say so honestly; recommend the cheapest real-world test (5 conversations, a smoke-test post) instead of inventing confidence.
  • Operator unavailable for the beachhead confirmation → record the recommendation in knowledge/pending.md and stop before writing the segment decision.

Outputs

knowledge/audience-profiles.md (beachhead + secondary segments), knowledge/research/competitors.md, knowledge/research/customer-language.md, raw notes in knowledge/research/. Seed knowledge/competitors.md (the living intel file) from the competitor map. Close with the report per templates/skill-report.md.

Writeback

Above files; segment decision (tag: audience) to knowledge/decision-log.md; unresolved unknowns flagged for /experiment or early sales conversations.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.