OpenSkillIndex← back to search
claude-code

Aiwg verify-citations

Verify all citations in a document against the research corpus

install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/frameworks/sdlc-complete/skills/verify-citations" ~/.claude/skills/jmagly-aiwg-verify-citations-9bdff5 && rm -rf "$T"
manifest: agentic/code/frameworks/sdlc-complete/skills/verify-citations/SKILL.md
source content

Verify Citations Command

Validate that all citations, references, and factual claims are backed by actual sources in the research corpus.

Instructions

When invoked, perform systematic citation verification:

  1. Parse Target File

    • Load the specified file (or all markdown files if no path given)
    • Extract all citation patterns: 
      • @.aiwg/research/sources/*
        references
      • @.aiwg/research/findings/*
        references
      • REF-XXX
        inline references
      • DOI patterns (
        10.XXXX/...
        )
      • Author-year patterns (
        Author et al., YYYY
        )

  2. Verify Each Citation

    • Check file existence for @-mention references
    • Validate REF-XXX against frontmatter in corpus
    • Verify DOI format validity
    • Check page number ranges
    • Validate quoted text against source

  3. Detect Hallucinations

    • Flag citations to non-existent files
    • Flag fabricated DOIs
    • Flag statistics without sources
    • Flag author names not in corpus

  4. Check GRADE Compliance

    • Load quality assessment for each cited source
    • Compare hedging language to evidence quality
    • Flag overclaiming (HIGH-confidence language for LOW evidence)

  5. Generate Report

    • Display summary table (total, valid, issues)
    • List each issue with severity and fix suggestion
    • Provide overall PASS/FAIL verdict

  6. Auto-Fix Mode (--fix)

    • Downgrade hedging language for GRADE violations
    • Remove citations to non-existent sources (with comment)
    • Add TODO markers for sources needing verification

Arguments

  • [file-path]
    - File to verify (default: all 
    .md
    files in current directory)
  • --strict
    - Treat warnings as errors
  • --fix
    - Automatically fix GRADE violations and remove hallucinated citations
  • --report
    - Save report to 
    .aiwg/reports/citation-verification.md
  • --corpus-only
    - Only check @-mention references, skip author-year patterns

References

  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/citation-policy.md - Citation enforcement rules
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/citation-verifier.md - Citation Verifier agent
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/citation-audit.yaml - Audit schema
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/hallucination-detection.yaml - Detection patterns