jmagly/citation-guard
plugins/sdlc/skills/citation-guard/SKILL.md
Verify citations against the research corpus to prevent hallucinated references and enforce GRADE compliance
$ install --global
skillsauthnpx skillsauth add jmagly/aiwg citation-guardInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 4, 2026, 7:25 AM114.7s1 file scanned
SKILL.md
- namespace:
- aiwg
- name:
- citation-guard
- platforms:
- [all]
- description:
- Verify citations against the research corpus to prevent hallucinated references and enforce GRADE compliance
citation-guard
Automatically verify citations when agents generate content that makes factual claims or references research.
Triggers
Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):
- "fabricated citations" / "hallucinated references" → citation authenticity check
- "DOI check" → citation DOI validation
- "verify sources" in research context → citation verification
Purpose
This skill acts as a passive citation guard, activating whenever agents generate content that includes citations or factual claims requiring evidence. It prevents citation hallucination by verifying references exist before they are written.
Behavior
When triggered, this skill:
-
Intercept citation generation:
- Detect when an agent is about to write content with citations
- Extract all REF-XXX, DOI, and @-mention references
-
Verify against corpus:
- Check each reference exists in
.aiwg/research/sources/or.aiwg/research/findings/ - Validate REF-XXX identifiers match frontmatter
- Flag any references not in corpus
- Check each reference exists in
-
Check GRADE compliance:
- Load quality assessment for cited sources
- Verify hedging language matches evidence quality level
- Suggest language corrections if overclaiming detected
-
Allow or warn:
- All citations valid: Proceed silently
- GRADE violation: WARN with suggested language fix
- Hallucinated citation: BLOCK with specific error
-
Track gaps:
- Log uncitable claims to
.aiwg/research/TODO.md - Track frequently needed but missing sources
- Log uncitable claims to
Activation Conditions
activation:
always_active_for:
- technical-writer
- documentation-synthesizer
- requirements-analyst
- architecture-designer
- domain-expert
- technical-researcher
triggers_on_content:
- pattern: "REF-\\d{3}"
- pattern: "@\\.aiwg/research/"
- pattern: "according to"
- pattern: "research (shows|demonstrates|suggests|indicates)"
- pattern: "\\(\\w+ et al\\., \\d{4}\\)"
Integration
This skill uses:
project-awareness: Load project's research corpus path- Citation Verifier agent for deep verification when needed
References
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/citation-policy.md - Citation policy rules
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/citation-verifier.md - Citation Verifier agent
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/hallucination-detection.yaml - Detection patterns
- @.aiwg/research/docs/grade-assessment-guide.md - GRADE methodology
Related Skills
jmagly/radar-status
data-ai
VerifiedTrustedCommunity
Report which research-corpus radar sidecars are overdue for refresh. Computes staleness (days since last refresh vs the cadence window) for every radar, sorted most-overdue-first. Runs via `aiwg corpus radar-status`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-report
data-ai
VerifiedTrustedCommunity
Aggregate research-corpus radar sidecars into a corpus or per-cluster freshness report — totals, overdue count, per-cluster / per-GRADE / per-trajectory breakdowns, an overdue table, and per-radar rationale snippets. Runs via `aiwg corpus radar-report`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-init
testing
VerifiedTrustedCommunity
Scaffold radar/freshness sidecars for research-corpus REFs. Pulls title/authors from the citation sidecar and GRADE from the analysis doc, defaults the refresh cadence from GRADE and the cluster from a corpus-local map, and stamps documentation/radar/REF-XXX-radar.md. Runs via `aiwg corpus radar-init`.
140SKILL.mdUpdated May 28, 2026
jmagly/profile-temporal
data-ai
VerifiedTrustedCommunity
Compute an entity's publication trajectory — per-year paper counts, topic drift, hot-streak detection (≥3 consecutive A-grade years), and career phase. Runs via `aiwg corpus profile-temporal`.
140SKILL.mdUpdated May 28, 2026