research-synthesis-data
Skill5 starsChanged 2 months agoMITView on GitHub
Convert raw discovery notes into structured insights using atomic research methods adapted for data products. Use when synthesizing findings, reviewing evidence, summarizing research, writing problem briefs, or when someone asks "what did we learn?" or "what does the evidence say?"
In this repository24 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- analystSkill
- arbitrage-audit-dataSkill
- dashboards-to-decisionsSkill
- databricks-data-product-reviewSkill
- data-consumer-discoverySkill
- data-model-designSkill
- data-pipeline-qualitySkill
- data-product-operatorSkill
- data-product-thinkingSkill
- data-product-validationSkill
- data-quality-assessmentSkill
- data-storytellingSkill
- data-team-operating-modelSkill
- data-team-positioningSkill
- duckdb-data-profilingSkill
- ethical-risk-assessmentSkill
- grill-me-dataSkill
- healthcare-cohort-designSkill
- healthcare-data-domainSkill
- healthcare-data-readiness-debriefSkill
- healthcare-data-reconciliationSkill
- metrics-definitionSkill
- stakeholder-alignmentSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
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
- Distinctive: line 22
When usage and interviews conflict, check identity, coverage, period, permissions and workflow definitions.
- Distinctive: line 58
Every discovery effort produces three artifacts:
- Distinctive: line 76
Never present a clean narrative when the evidence is messy.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Evidence Hierarchy
Assess evidence for the specific question, coverage, independence and recency. These source types offer different signals, not a universal ranking:
- Observed workarounds: Record the task, cost and alternatives using
data-consumer-discovery. Investment shows effort, not validated demand or willingness to buy. - Usage data: Query logs, dashboard access and API calls show recorded behavior within instrumentation and access limits.
- Quality incidents: Tickets and escalations show reported problems; silence does not establish absence of harm.
- Consumer quotes: Preserve wording, context and independence. Repeated quotes can suggest a pattern, not a fixed validation threshold.
- Stakeholder requests: Separate the requested solution from the decision, constraints and authority behind it.
When usage and interviews conflict, check identity, coverage, period, permissions and workflow definitions. Logs may miss off-platform work; interviews may describe intended rather than observed behavior. Preserve unresolved contradictions.
Atomic Research Chain
Build insights from the bottom up. Every level must trace to the one below it.
Nuggets
Raw observations tagged with source and date. One fact per nugget.
Synthetic example: [Fictional interview: Sarah, Analytics Lead, 2024-01-15] Spends 4 hours every Monday rebuilding the regional performance report from 3 separate data exports.
Tag each nugget: source type (interview, log, ticket, observation), consumer segment (Explorer, Reporter, Decision-maker, Builder), and topic.
Patterns
Group observations that support the same explanation. Report the sample, independence and contrary cases. No universal count establishes a pattern; a single well-supported safety event can still require action.
Synthetic example: 3 of 5 analytics leads manually combine data from 3+ sources weekly. Average reported time: 3.5 hours. They report distrust of the automated totals. The sample does not establish demand across the organization.
Insights
Patterns interpreted in context. Answers "so what?"
Synthetic interpretation: Definition differences may explain the regional reporting mismatch. Compare the same population and period under each definition before claiming a cause or forecasting time saved.
Recommendations
Insights translated into action. Each recommendation links to a specific skill or command:
- Problem Brief → feeds
data-product-validationscorecard - Data Landscape Assessment → feeds
data-quality-assessmentaudit - Consumer Map → feeds
stakeholder-alignmentprioritization
Three Synthesis Outputs
Every discovery effort produces three artifacts:
1. Problem Brief — The top 3 problems ranked by evidence strength. For each: problem statement, evidence summary (nuggets and patterns), affected consumer segments, estimated impact. Feeds directly into /data-product-operator:write-data-prd.
2. Data Landscape Assessment — Current state of relevant data sources. For each: what exists, quality baseline (cross-ref data-quality-assessment), gaps, access constraints. Feeds into data-product-validation Data Feasibility scoring.
3. Consumer Map — Who needs what, segmented by type (see data-consumer-discovery segments). Includes: frequency of need, current workaround, trust level, downstream dependents. Feeds into stakeholder-alignment prioritization.
Contradictory Evidence
When evidence conflicts:
- Flag the contradiction explicitly. Do not smooth it over or pick the more convenient interpretation.
- Compare scope, timing, source reliability and independence. Do not choose a winner by source type alone.
- Record competing explanations and a targeted follow-up that could distinguish them.
Example: "Interview data suggests daily demand, but query logs show weekly access. Recommend monitoring actual usage for 2 weeks before committing to real-time refresh SLA."
Never present a clean narrative when the evidence is messy. Stakeholders deserve honest uncertainty over false confidence.
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.

