agentleFS
UsermuseUsermuse/em-plugin/skills/segmentation/SKILL.md

segmentation

Skill0 starsChanged 3 months agoMITView on GitHub

Segment a market or user base by evidence-based need differences — not demographics — into 3-5 distinct groups, each with its jobs-to-be-done, pains, product fit, and representative customer quotes. Use when the user says 'segment our users', 'segment the market', 'who are our target segments', 'what customer segments do we have', 'break users into groups', or wants a needs-based segmentation model. Trigger terms: segmentation, market segments, user segments, customer segments, target audiences, segment the market, needs-based groups. Not for arbitrary demographic buckets with no behavioral difference.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Required — one parallel batch of searches: Verify the product (Rule 1), then fire in a single parallel batch:

    line 35

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Segmentation (needs-based, from the corpus)

Split the market or user base into groups that differ in what they need, not just in what they look like. Real segments earn their keep by pointing at different product bets; demographic buckets that all want the same thing don't. Every segment here is defined by evidence of a distinct need and carries the customers' own voice.

Step 0 — Relevance & availability

Confirm this is segmentation work and Evermuse is connected (see using-evermuse Step 0). If disconnected, produce a framework-only model labeled ⚠ ungrounded and tell the user to authorize the MCP.

Two altitudes — pick one

  • User segmentation (existing users, from feedback) → segments come from the corpus; save nature=evidence.
  • Market segments (the broader addressable market, incl. non-users) → market-level cuts lean on context searches (industry/analyst signals) validated by customer evidence; the customer-derived parts still save as evidence. State which you're doing up front. Default to user segmentation unless the user is clearly exploring a market they don't yet serve.

Evermuse Grounding (required)

Follow ${CLAUDE_PLUGIN_ROOT}/skills/using-evermuse/SKILL.md.

Required — one parallel batch of searches. Verify the product (Rule 1), then fire in a single parallel batch:

  • 3–4 evidence searches, each worded from a different angle (limit up to 50). Evidence comes back rich and varied — expect large, useful result sets.
  • one guidance search and one context search (limit up to 50). These are usually sparse or empty; run them anyway and note when they're thin.

Read each response's digest — it reports how many more results exist. Use judgment on whether a query is worth pulling deeper (raise limit toward the 100 max and/or page with next_offset to avoid repeats), weighing payload size, remaining context, task complexity, and the value of the data. For deep pulls, consider spawning sub-agents — instruct them to return every citation with the same metadata the tools return (url, who_said_it, meeting_name, created_at) so you can still cite.

Optional — considered use. Once grounded, reach for the other tools only when they add value: a quote-angled search for verbatim voice, read_source for a single deep dive, inline citations (references/citations.md), and add_source to save the deliverable. Sources, citations, and saving are optional — not required.

Instructions

Segment $ARGUMENTS into 3-5 distinct groups.

  1. Choose segmentation dimensions from the evidence — behavioral (how they use it), needs-based (the job), workflow context. Reject a demographic dimension unless the evidence shows it maps to a real difference in need.
  2. Define segments so they're measurable, non-overlapping, and each points at a different product decision.
  3. Characterize each segment with the structure below, quoting real customers. Where the source method says "if the user provides data" or reaches for market studies, use evidence searches (and context only for market-size color).
  4. Validate distinctness — if two segments want the same things, merge them. Fewer real segments beats more fake ones.

Segment profile (each of 3-5)

Name & one-line characterization — memorable, and says what makes it different.

Size / weight — rough share of the corpus (accounts/mentions), labeled as a corpus estimate, not a market number, unless you have context data.

Jobs-to-be-done — the primary job, its context, frequency, and success criteria for this group.

Key pains & unmet needs — badged with the accounts they came from.

Representative voice — 1-2 verbatim quotes:

> "[verbatim quote]" — [Name], [Meeting], [Date] [`1`](URL)

Product fit — how well the product serves this segment today; the sharpest gap.

Differentiated value / positioning — what would move this segment most, and the messaging that resonates.

Priority — invest / maintain / de-prioritize, with a one-line rationale (growth, revenue, strategic fit vs. effort).

Close with a note flagging any segment that's underrepresented in the corpus. This pairs naturally with /evermuse:user-personas (a persona per segment) and market-sizing.


Further reading

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.