research
Skill2 starsChanged 3 months agoMITView on GitHub
Proposes and scores candidate audience segments from an operator's description of their business, using an 8-dimension diagnosis weighted per-business rather than a fixed rubric — and states the reasoning behind that weighting before scoring runs. Actually searches the web when a search capability is available, both to help describe an unfamiliar company and to source evidence for scoring; asks the operator to paste material when it isn't. Reads using-fan-development-skills first for the toolkit's operating behaviors and mode detection. Use when an operator doesn't know which audience segment to prioritize, wants to pressure-test a segment they already believe in, or is starting the fan-development-skills flow from scratch.
189 other projects use a version of this.
Adopted by
Most recently taken up by
- dialog-db/dialog-dbtheir own version, first seen Nov 9, 2026
- howells/skillstheir own version, first seen Nov 8, 2026
- xiaoxiaosrm/dsh-mattpocock-skillstheir own version, first seen Nov 8, 2026
- Suge8/friedbuntheir own version, first seen Nov 8, 2026
- wowyuarm/dsh-agent-teamtheir own version, first seen Nov 8, 2026
- Contexera/dsh-agent-teamtheir own version, first seen Nov 8, 2026
Used with
Projects with it also use daily-arxiv, exp-eval and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
LambenthanSkilldaily-arxiv
每日从 arXiv 拉取新论文,过滤相关性,auto-ingest 高优先级论文,检测 SOTA 更新
Also in 5 projects that use this
LambenthanSkillexp-eval
实验判决门:Review LLM 独立评判实验结果 → 4 种判决路径 → 自动更新 claims confidence、ideas status、graph edges
Also in 5 projects that use this
truongtv22SkillProblem-Solving Techniques
Apply systematic problem-solving techniques for complexity spirals (simplification cascades), innovation blocks (collision-zone thinking), recurring patterns (meta-pattern recognition), assumption constraints (inversion exercise), scale uncertainty (scale game), and dispatch when stuck. Techniques derived from Microsoft Amplifier project patterns adapted for immediate application.
Also in 5 projects that use this
liufeng1976Skillsetup-ts-deep-modules
Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.
Also in 43 projects that use this
skyllwtSkillexp-pilot-eval
Pilot result evaluation — read pilot results, apply success criteria, update idea page (pilot_result, failure_reason if failed), generate PILOT_VERDICT_REPORT. Called by /ideate Phase 5 after /exp-pilot-run.
Also in 4 projects that use this
skyllwtSkillexp-pilot-run
Pilot experiment execution — read Pilot Spec YAML, write pilot code, run experiment(Confirm with the user before operation and require the applicant to conduct manual inspection), return results. Called by /ideate Phase 5. Does NOT modify wiki pages or judge pass/fail.
Also in 4 projects that use this
- +5 more from Lambenthan
- +1 more from skyllwt
Other versions189 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 189
- mattpocock/skills★ 309ksame name
- Yeachan-Heo/oh-my-claude-sisyphus★ 41ksame name
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
- QuivrHQ/quivr★ 40ksame name
- The-Vibe-Company/quivr★ 40ksame name
- udecode/plate★ 17ksame name
- openai/plugins★ 7.8ksame name
- ArcReel/ArcReel★ 6.3ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- withcoral/coral★ 4.9ksame name
179 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- awarenessSkill
- engagementSkill
- integrationSkill
- using-fan-development-skillsSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
16 rules. 0 are common, 14 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 169 edited versions we read keep these.
14
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 23
Run automatically first, always, in the router's Full-Flow Mode — its output is the weighting input for awareness, engagement, and …
- Very specific: line 31
Before anything else, read and apply using-fan-development-skills/SKILL.md — it defines the Core Operating Behaviors, detects Single-Skill …
- Distinctive: line 57
Ask for the company or product name.
- Distinctive: line 58
Ask whether to research it (search the web to draft a description) or take the operator's own description instead.
- Distinctive: line 60
If web-researched: draft the description, show it back, and confirm it's accurate before continuing.
- Distinctive: line 62
If operator-provided: use it as given — it's already theirs, no confirmation loop needed.
- Distinctive: line 67
Before proposing candidates, ask the operator directly: "Are there any key metrics, data sources, resource considerations, priorities or …
- Distinctive: line 70
Wait for their answer and fold anything they share into the business/audience understanding before moving to Propose Candidates below.
- Distinctive: line 75
Start from the default list: new/first-touch users, lapsed users, power users not yet advocates, adjacent-market prospects, …
- Distinctive: line 77
Add candidates the business/audience description or shared data actually suggests.
- Distinctive: line 85
Before searching or asking for material, reason out loud about what kind of external evidence actually matters for this business — a …
- Distinctive: line 94
If a web search or fetch capability is available in this session, use it — both to fill in the business description above and to source …
- Distinctive: line 113
Wait for their reaction before scoring.
- Distinctive: line 125
No search capability, or a search that comes back thin: ask the operator to paste source material directly rather than inventing evidence …
- Distinctive: line 158
Every run proposing the same five default segments with no business-specific additions.
- Distinctive: line 174
Before treating a run as complete, confirm:
“Common” is measured: kept by at least 6 in 10 of the 169 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.
Files
Research
Overview
research is the diagnostic entry point for this toolkit. Given a description
of a business and its audience, it proposes candidate segments, scores them on
eight dimensions, and recommends which funnel stage — awareness, engagement,
or integration — is the actual bottleneck for the top segment. Everything else
in this toolkit either consumes that diagnosis (the router's Full-Flow Mode)
or exists to pressure-test one segment on its own (thought-partner mode).
When to Use
- An operator doesn't know which segment to prioritize and wants a from-scratch diagnosis.
- An operator already has a segment in mind and wants it pressure-tested, not just validated.
- Run automatically first, always, in the router's Full-Flow Mode — its output
is the weighting input for
awareness,engagement, andintegration. - Not for refining an already-agreed single-stage program with no segment
question attached — go directly to
awareness,engagement, orintegrationfor that.
Read First
Before anything else, read and apply
using-fan-development-skills/SKILL.md — it defines the Core Operating
Behaviors, detects Single-Skill vs. Full-Flow Mode, and defines Session
Continuity & File Output. Check for an existing research.md for this
business before proceeding, and read it in as context if one exists.
Everything below assumes those behaviors are already active.
Resolve the Intake
Two things get resolved before any proposing or scoring happens.
1. Mode.
- Build-from-scratch — the operator doesn't have a segment yet, or wants a full diagnosis from zero.
- Thought-partner/refine — the operator already has a segment or in-flight program and wants it pressure-tested. Skip Propose Candidates below; score only the segment(s) they name.
2. Starting point, regardless of mode — what the operator has to work from:
- Share data — they paste or describe real data about their audience.
- Identify softening — they name where a metric is declining.
- Name a target metric — they state what they want to move, with no current baseline.
Build-from-scratch only — establish what the business is:
- Ask for the company or product name.
- Ask whether to research it (search the web to draft a description) or take the operator's own description instead.
- If web-researched: draft the description, show it back, and confirm it's accurate before continuing. Do not proceed on an unconfirmed description.
- If operator-provided: use it as given — it's already theirs, no confirmation loop needed.
Confirm Coverage (build-from-scratch mode only)
Before proposing candidates, ask the operator directly: "Are there any key metrics, data sources, resource considerations, priorities or anything else about the business you'd like to add before we generate segment candidates?" Wait for their answer and fold anything they share into the business/audience understanding before moving to Propose Candidates below.
Propose Candidates (build-from-scratch mode only)
- Start from the default list: new/first-touch users, lapsed users, power users not yet advocates, adjacent-market prospects, internal/employee advocates. This list is a floor, never a ceiling.
- Add candidates the business/audience description or shared data actually suggests. A run that scores only the five defaults, unmodified, regardless of what business it's given is a bug, not a valid outcome — pressure yourself to find at least one segment specific to what the operator described.
Source Discernment
Before searching or asking for material, reason out loud about what kind of external evidence actually matters for this business — a consumer app implies app-store reviews and social listening; a B2B/enterprise product implies analyst reports and community benchmarks; a local/physical business implies local market data. State this reasoning; never apply a fixed hierarchy regardless of business type.
Search or Ask
If a web search or fetch capability is available in this session, use it — both to fill in the business description above and to source real evidence for scoring below. This is the default path, not a hypothetical to describe and then skip. If no such capability is available, say so plainly and ask the operator to paste source material instead — see Graceful Degradation.
Weight the Dimensions
The eight dimensions — strategic fit, evidence of affinity, segment size, conversion likelihood, repeat/retention potential, ease of activation, operational feasibility, evidence confidence — are never weighted the same way twice. Before scoring:
- State a summary of the business/audience understanding built so far.
- Propose a specific weighting — which dimensions matter more for this business and why — with the reasoning tied to that context.
- Pose it back to the operator as a question, guess attached — summary, then a question, then a guess for how they'd weight it based on the context built so far.
- Wait for their reaction before scoring. Fold in any correction.
Score
Score every candidate segment (defaults plus additions, or the named
segment(s) in thought-partner mode) against the weighted dimensions. Any
claim without solid evidence — a size estimate, a conversion assumption, a
"this segment behaves like X" comparison — gets LOW_EVIDENCE explicitly,
not smoothed into a confident-sounding number.
Graceful Degradation
No search capability, or a search that comes back thin: ask the operator to paste source material directly rather than inventing evidence to fill the gap. This is a first-class fallback, not an edge case — state plainly when it's happening, don't silently degrade quality without saying so.
Output the Brief
- Ranked candidate segments — or, in thought-partner mode, the named segment's score with a note on how it compares to what a from-scratch scan would likely surface.
- Evidence per dimension, with
LOW_EVIDENCEflags visible, not buried in prose. - A recommended stage emphasis for the top segment(s) — is the bottleneck awareness, engagement, or integration? This becomes the weighting input if the operator continues into the full flow.
- Close per Mode Detection in the router: Single-Skill Mode ends with a stated next-step recommendation; the Full-Flow check-in stop is the router's job, not this skill's.
- Save to
fan-development/<business-slug>/research.mdper the router's Session Continuity & File Output, and state the path in the close.
Common Rationalizations
| Rationalization | Reality |
| "I already searched the web for the description, no need to also confirm it with the operator." | Searching and confirming aren't substitutes for each other. Draft it from the search, then still show it back — the operator catches a wrong assumption in five seconds; you won't catch your own. |
| "The default five segments already cover this business well enough." | That's the outcome to distrust most. If every run lands on the same five, the diagnosis isn't adapting to what's actually described — go back and look for what's specific to this business. |
| "Equal weights across all 8 dimensions is safer than committing to a business-specific rationale." | Equal weighting is itself a claim — that all eight matter the same for this business — and it's usually wrong. State the real reasoning and let the operator correct it if it's off. |
| "The operator clearly wants me to validate the segment they already named." | Pressure-testing means it might not survive. Score it honestly — confirming a bad bet a week before budget commits is worse than telling them now. |
| "Search came back thin, I'll fill the gaps with reasonable industry assumptions." | That's inventing evidence. Say the search came back thin and ask for pasted material — don't let a weak result quietly become a confident-sounding claim. |
Red Flags
- Every run proposing the same five default segments with no business-specific additions.
- Weighting applied without ever stating the reasoning behind it, or applied identically across unrelated business types.
- A
LOW_EVIDENCE-worthy claim presented without the flag. - A web-researched business description used without ever being shown back for confirmation.
- Build-from-scratch mode moving straight from the business description into Propose Candidates without asking the operator if there's anything else to add first.
- Thought-partner mode running a full candidate-proposal sweep the operator didn't ask for.
- A search capability available in the session but never actually invoked.
Verification
Before treating a run as complete, confirm:
- Mode (build-from-scratch vs. thought-partner) and starting point were resolved before any proposing or scoring
- Build-from-scratch: the business description is either operator-provided or web-researched-and-confirmed before continuing
- Build-from-scratch: the operator was explicitly asked for any key metrics, data sources, resource considerations, or priorities to add, before candidates were proposed
- At least one candidate segment beyond the default five, when the business description supports one
- Source-discernment reasoning was stated out loud, not applied as a fixed hierarchy
- A web search capability was actually invoked when available in the session
- Dimension weighting was reasoned per-business and confirmed with the operator via the summary/question/guess pattern before scoring
- Every
LOW_EVIDENCE-worthy claim is flagged, not smoothed over - Output includes ranked segments (or the thought-partner score), evidence, confidence flags, and a stage-emphasis recommendation
- An existing
research.mdfor this business was checked for and read first if one existed; the brief was saved to the correct path per Session Continuity & File Output
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
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.

