Skip to content
Skills Library
Science & research · Review & audit

refwarden

/refwarden

Run the refwarden reference and citation audit on a manuscript, a single DOI, or a claim. Triggers: 'check my references', 'reference check', 'are any of my citations retracted', 'smart citations for this paper', 'how is this paper cited', 'is this paper contested', 'does this source support my claim', 'find evidence against this claim', 'check citations before submission', 'check figure and table references', 'Error! Reference source not found'. Produces a finding ledger, an author letter, CSV and JSON. Do NOT use for full manuscript review, for writing a literature synthesis, or for citation

Repository
refwarden ↗
Licence
Apache-2.0
Last repository change
08.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Run the refwarden reference and citation audit on a manuscript, a single DOI, or a claim. Triggers: 'check my references', 'reference check', 'are any of my citations retracted', 'smart citations for this paper', 'how is this paper cited', 'is this paper contested', 'does this source support my claim', 'find evidence against this claim', 'check citations before submission', 'check figure and table references', 'Error! Reference source not found'. Produces a finding ledger, an author letter, CSV and JSON. Do NOT use for full manuscript review, for writing a literature synthesis, or for citation

Triggers from the description

check my referencesreference checkare any of my citations retractedsmart citations for this paperhow is this paper citedis this paper contesteddoes this source support my claimfind evidence against this claim
Original author description

Run the refwarden reference and citation audit on a manuscript, a single DOI, or a claim. Triggers: 'check my references', 'reference check', 'are any of my citations retracted', 'smart citations for this paper', 'how is this paper cited', 'is this paper contested', 'does this source support my claim', 'find evidence against this claim', 'check citations before submission', 'check figure and table references', 'Error! Reference source not found'. Produces a finding ledger, an author letter, CSV and JSON. Do NOT use for full manuscript review, for writing a literature synthesis, or for citation

How it works

  1. Pick the job
  2. Procedure (audit)
  3. Where the output goes
  4. Output modes
Original SKILL.md headings · 53 lines, 495 words
SKILL.md preview
---
name: refwarden
metadata:
  version: "0.1"
description: "Run the refwarden reference and citation audit on a manuscript, a single DOI, or a claim. Triggers: 'check my references', 'reference check', 'are any of my citations retracted', 'smart citations for this paper', 'how is this paper cited', 'is this paper contested', 'does this source support my claim', 'find evidence against this claim', 'check citations before submission', 'check figure and table references', 'Error! Reference source not found'. Produces a finding ledger, an author letter, CSV and JSON. Do NOT use for full manuscript review, for writing a literature synthesis, or for citation formatting."
---

# refwarden — reference and citation audit

A tool, not a reviewer. It checks references and citations against open registries (Crossref
with Retraction Watch data, Semantic Scholar, Europe PMC, OpenAlex) and returns findings as a
ledger. Every run is `UNVALIDATED` until a second, independent rater (another session or model)
or the author validates it.

## Pick the job

| Need | Command (CLI) | MCP tool |
|---|---|---|
| Audit a manuscript's references and citations | `refwarden audit FILE [--deep]` | `refwarden_audit_manuscript` |
| Figures, tables, sections, appendices, equations: do the text's pointers resolve | `refwarden xrefs FILE` (offline) | `refwarden_check_crossrefs` |
| How one paper is cited; is it contested or retracted | `refwarden paper DOI` | `refwarden_paper_report` |
| Is this one reference real and correct | `refwarden resolve "REF"` | `refwarden_resolve_reference` |
| Evidence against a claim (conflict register input) | `refwarden counter "CLAIM"` | `refwarden_counter_evidence` |
| Pre-submission sweep of a stored audit | `refwarden recheck RUN_ID` | — |
| Alerts on sources a portfolio relies on | `refwarden watch add DOI…` / `watch run` | — |

If neither the CLI nor the MCP server is available, say so and stop; do not reconstruct registry
results from memory. A reference asserted from recall is exactly as fluent when fabricated.

## Procedure (audit)

1. Run the audit. Read the coverage block first: references resolved, sources used, sources
   skipped, errors. References the registries could not reach are unaudited, not clean.
2. Judge the claim-fit items. When the run has no model, fetch the packet
   (`refwarden_judgement_packet` or `refwarden packet RUN_ID`), judge every item by the packet's
   instructions, and submit with role `primary`. Quote the abstract verbatim; the tool checks.
3. Report the ledger as produced. Do not raise a finding's confidence: `Confirmed` comes only from
   registry records, the manuscript text, or a human validation with a verified quote. Two models
   agreeing is concordance, not confirmation.
4. Hand validation to a different session or model tier (`--role validation`, blind packet), or to
   the author. The session that produced the verdicts never validates them.
5. Author dispositions (`Accepted / Disputed / Deferred / Evidence-required`) are recorded with
   `refwarden status`; they survive `recheck`, and accepted risks are not reopened without new evidence.

## Where the output goes

- **Manuscript review:** copy ledger rows (IDs `REF-nn`, `XREF-nn`) into the review report with their
  IDs, so reruns and `status` decisions line up. A reviewer may lower a row's confidence, not raise it.
- **Literature synthesis:** `independence` findings show how many separate lines of evidence a
  sentence rests on; `counter` output and `contested` findings list evidence against a claim;
  `resolve` checks a reference live instead of from memory.
- **Before sending:** `recheck RUN_ID` re-queries every reference's editorial status without the cache.

## Output modes

`-f md` internal ledger · `-f author` plain-language letter (no IDs or codes; hedges preserved:
Confirmed → "Verified", Probable → "Our assessment, not confirmed", Question → "Please check") ·
`-f csv` · `-f json`.

Versions

The database has no other skills named refwarden.

Database snapshot: 13.11.2026 · package version a449be810786 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100claim-citation-auditor
    Audit scientific manuscripts by mapping each claim to the citation(s) that support it, validating reference metadata (DOI/PMID/title/authors/year), retrieving the cited sources, and judging whether each source actually supports the claim. Use this whenever a user wants to check…
  • 100citation-audit
    Audit every citation in a manuscript for existence and for faithfulness. Triggers when user says: 'audit my citations', 'verify all citations', 'check every reference', 'citation integrity check', 'do my sources exist', 'are my citations real', 'audit the bibliography', 'verify…
  • 100manuscript-review
    Pre-publication manuscript audit producing a section-level refactoring report with citation hygiene and submission-readiness checks. Triggers on: "review my paper", "check before submission", "is this ready to submit", "pre-pub checklist", "refactor my paper", "check my…
  • 100citation-context
    Map a paper's citation network from a DOI, arXiv ID or exact title — backward references, forward citations, relevance ranking, co-citation clusters, a verifiable narrative and a single-file interactive HTML report. Use when asked "who cites this paper", "what does it build on",…
  • 100reference-verifier
    Verify the references/bibliography of an academic paper. Use this skill whenever the user wants to check, verify, validate, audit, or sanity-check the references, citations, or bibliography of a paper, manuscript, or preprint. Triggers include: 'verify references', 'check the…
  • 100claim-check
    Check every claim and citation in a manuscript, thesis chapter, grant proposal, or report against the cited papers in a Continua Project Room, and flag unsupported, overstated, misattributed, or outdated statements with the exact source text. Use for citation verification,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.