research-doc

Write citation-validated research documents with adversarial review and provenance ledgers.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/sergeiwallace/skills --skill research-doc-sergeiwallace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-doc
Source: https://github.com/sergeiwallace/skills/tree/main/skills/research-doc
Command: npx skills add https://github.com/sergeiwallace/skills --skill research-doc-sergeiwallace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typer, pydantic-settings, skill-cli-foundation, and includes scripts (resource) components.

What problem does it solve? Research write-ups often contain unverified claims, dead citations, and hallucinated sources. This Skill produces research documents where every load-bearing claim is fetched live, cross-checked, tagged by evidence tier, and recorded in a provenance ledger. ## Core Features & Use Cases - Grounded research workflow: Assembles a prompt from a bundled template enforcing Chain-of-Verification, multi-framing search fan-out, and a retrieval floor so no section ends without a fetched source. - Adversarial review and citation validation: Runs five critic perspectives (conventional, contrarian, historical, adjacent, skeptic) and fetches every citation, classifying access failures such as 404s, paywalls, and DNS errors. - Provenance ledger and claim tiers: Tags claims as [VERIFIABLE], [HEURISTIC], [INFERENCE], or [NO SOURCE], with a claim-to-quote-to-verdict ledger for every verifiable statement. - Use Case: Ask for a scoped write-up like "research vector database consistency models"; the Skill scaffolds docs/research/<slug>.md from the bundled stub, researches with live fetches, and delivers a document with footnoted sources and a full audit trail. ## Quick Start Ask the agent to research a topic and write it up, for example: use research-doc to investigate current approaches to LLM evaluation and produce a cited research document.

Frequently Asked Questions about research-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a research document with verified citations using an AI agent?

Invoke the research-doc skill with a topic, optionally with --inline, --model, or --refine flags. It scaffolds a document from the bundled stub, requires a live fetch for every load-bearing claim, and records each verified claim in a provenance ledger with a verbatim quote.

How does the skill prevent hallucinated sources in research output?

It fetches every citation during the session and never accepts URLs from model memory. Claims are tagged [VERIFIABLE] only when the quote literally appears in fetched text, the entailment verdict is SUPPORTED, and the URL is live; otherwise they are downgraded or flagged.

Can research-doc delegate the research to an external agent or model?

Yes, if the installation sets RESEARCH_DOC_DELEGATION_ADAPTER to an executable path, the skill hands it the topic, target, assembled prompt, model preference, and mode. When unset or failing, it falls back to inline authoring in the current session.

What happens when a cited source is unreachable or paywalled?

Failures are classified: DNS errors downgrade the claim hard, 404s trigger a Wayback availability check, 401/403 responses are kept and flagged with a bot-block ladder, and timeouts are retried once. No citation is silently dropped.

What are the limitations of the research-doc workflow?

It depends on web search and fetch tools being available in the host environment, and the bundled resolver script requires Python 3.11 with uv plus a local skill-cli-foundation package. It produces markdown research documents, not slides or other formats.