web-research-synthesizer
Skill2 starsChanged 4 months agoMITView on GitHub
Runs structured multi-source research: decomposes a question, searches deliberately, rates source credibility, cross-verifies claims, resolves contradictions and delivers a cited synthesis with an explicit confidence level per claim. Use when the user asks to research a topic, compare options or vendors, check whether something is true, gather current market or technical information, or produce a briefing that must be sourced.
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- accessibility-auditorSkill
- contract-reviewerSkill
- csv-data-profilerSkill
- dependency-auditorSkill
- git-workflow-assistantSkill
- meeting-notes-to-actionsSkill
- prompt-engineering-optimizerSkill
- release-notes-generatorSkill
- rest-api-designerSkill
- security-code-reviewSkill
- sql-query-optimizerSkill
- technical-writing-editorSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
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 25
Do not use for: questions answerable from stable general knowledge, or opinion pieces with no factual load.
- Distinctive: line 43
Search for the counter-position explicitly ("X limitations", "X vs Y criticism", "why we moved off X").
- Distinctive: line 45
Prefer primary sources: official docs, filings, standards, datasets, the original paper — not an article about them.
- Distinctive: line 47
Add a time filter for anything fast-moving.
- Distinctive: line 49
Stop when new sources stop changing the answer (saturation), not when you hit a source count.
- Distinctive: line 62
Always check: who benefits from this claim, is the author named, is the date visible, are sources cited, has it been updated since …
- Distinctive: line 70
Every load-bearing claim needs two independent sources.
- Distinctive: line 74
When sources conflict: report the conflict, date each position, and explain the likely cause (different methodology, different scope, one …
- Distinctive: line 87
Never upgrade confidence because a claim is repeated by many low-tier sources.
≈ “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
Web Research Synthesizer
Produce something a sceptical reader can check. Unsourced assertion is the failure mode, not a shortcut.
When to use
Comparisons, market or technical landscape scans, fact-checking, due diligence, "what is the current state of X", literature-style briefings.
Do not use for: questions answerable from stable general knowledge, or opinion pieces with no factual load.
Workflow
1. Decompose the question
Convert the request into 3–7 answerable sub-questions and state what evidence would settle each one. Identify the decision behind the question — research that does not change a decision is wasted.
Flag immediately: ambiguous scope, an unstated timeframe, or a question that is actually a value judgement rather than a factual one.
2. Search deliberately
- One sub-question per query; vary phrasing between a technical and a plain formulation.
- Search for the counter-position explicitly ("X limitations", "X vs Y criticism", "why we moved off X"). Confirmation bias is the main risk here.
- Prefer primary sources: official docs, filings, standards, datasets, the original paper — not an article about them.
- Add a time filter for anything fast-moving; check the publication and last updated date on every page.
- Stop when new sources stop changing the answer (saturation), not when you hit a source count.
3. Rate every source
| Tier | Examples | Weight |
| A — Primary | Official docs, standards, regulatory filings, raw datasets, source code | Highest |
| B — Expert secondary | Peer-reviewed work, established analyst firms, recognised practitioner writing | High |
| C — Reputable press | Quality journalism with named sources | Medium |
| D — Community | Forums, blogs, Q&A, social posts | Low — signal for leads, not proof |
| E — Unreliable | Content farms, undated pages, AI-generated aggregators, vendor marketing about itself | Excluded from claims |
Always check: who benefits from this claim, is the author named, is the date visible, are sources cited, has it been updated since publication.
Vendor material is Tier A for their own product's specifications and pricing, and Tier E for any comparison with competitors.
4. Cross-verify
- Every load-bearing claim needs two independent sources. Two outlets citing the same press release count as one.
- Trace numbers back to origin. "Studies show 73 %" usually terminates in a single small survey commissioned by an interested party.
- When sources conflict: report the conflict, date each position, and explain the likely cause (different methodology, different scope, one is stale, one is interested). Do not average them; do not silently pick one.
5. Assign confidence per claim
| Level | Criteria |
| High | Multiple independent Tier A/B sources agree; recent; no contrary evidence found |
| Medium | One strong source, or several weaker ones agreeing; no contradiction found |
| Low | Single source, dated, contested, or inferred rather than stated |
| Unknown | Searched and not found — say so; absence of evidence is a finding |
Never upgrade confidence because a claim is repeated by many low-tier sources.
6. Deliver
## Answer two to four sentences, up front
## Key findings each with [n] citations and (Confidence: …)
## Comparison table, when options are being weighed
## Contradictions what disagrees, and why
## Gaps what could not be established, and what would settle it
## Sources [n] Title — Publisher — date — tier — URLCite inline with numbered references. Attribute every number and every quote. Separate fact, interpretation and your recommendation into distinct sentences — never blend them.
Worked example
Question: "Is Postgres a viable replacement for our Kafka event bus?"
Decomposition
- What throughput can Postgres-based queues sustain? (technical limit)
- What features are lost versus Kafka? (retention, replay, partitioning, consumers)
- What is our actual throughput and retention requirement? — unanswerable from the web; asked the user
- Who has done this in production, and what did they hit? (case evidence)
Finding (extract)
Postgres-based queues using
SKIP LOCKEDsustain roughly 10³–10⁴ messages/s on commodity hardware before vacuum and WAL pressure dominate [1][3] (Confidence: Medium — two benchmarks, different hardware and schemas; neither is an independent reproduction of the other).Kafka's log retention with independent consumer offsets has no direct Postgres equivalent; replay must be built manually [2] (Confidence: High — stated in both projects' documentation).
Gap: no source found for sustained multi-day retention at your stated volume. This would be settled by a two-week load test on your own schema — the deciding variable is your requirement (#3), not the technology.
Contradiction: a vendor blog claims 50k msg/s on Postgres [4]; it omits durability settings and the publisher sells a Postgres queue product. Tier E for this comparison — excluded.
Quality checklist
- Every factual claim carries a citation
- Load-bearing claims verified across independent sources
- Source tier and publication date recorded for each reference
- Counter-evidence actively searched, not just supporting evidence
- Contradictions surfaced, not smoothed over
- Confidence stated per claim, and justified
- Gaps and unanswerable questions listed explicitly
- Fact, interpretation and recommendation kept separate
- No paraphrase that strengthens the original claim
Failure modes
| Situation | Response |
| Nothing credible found | Say so plainly; list what was searched; suggest who would know |
| All sources trace to one origin | Report it as a single source, whatever the article count |
| Topic is contested/political | Present positions with attribution; do not adjudicate |
| Information changes fast | Date-stamp the answer and state its shelf life |
| Paywalled primary source | Do not infer content from the headline; mark it as unverified |
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.

