Codex

citation-check

Check a file for citation quality and GRADE compliance

104 stars

Best use case

citation-check is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

It is a strong fit for teams already working in Codex.

Check a file for citation quality and GRADE compliance

Teams using citation-check should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/citation-check/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/citation-check/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/citation-check/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How citation-check Compares

Feature / Agentcitation-checkStandard Approach
Platform SupportCodexLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Check a file for citation quality and GRADE compliance

Which AI agents support this skill?

This skill is designed for Codex.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Citation Check Command

Quick check of a single file for citation validity and GRADE-appropriate hedging.

## Instructions

When invoked, perform quick citation check:

1. **Parse File**
   - Extract all citations (REF-XXX, @-mentions, author-year)
   - Map each citation to its GRADE level (from quality assessments)

2. **Check Hedging Compliance**
   - For each citation, verify the surrounding language matches GRADE level:
     - HIGH: "demonstrates", "shows", "confirms" - OK
     - MODERATE: "suggests", "indicates" - OK
     - LOW: Must use "limited evidence", "some data"
     - VERY LOW: Must use "anecdotal", "exploratory"

3. **Report**
   - List each citation with its GRADE level
   - Flag violations (overclaiming)
   - Suggest fixes for violations

4. **Auto-Fix (--fix)**
   - Replace overclaiming language with GRADE-appropriate hedging
   - Preserve meaning while adjusting confidence level

## Arguments

- `[file-path]` - File to check (required)
- `--fix` - Automatically fix hedging violations
- `--strict` - Treat all GRADE violations as errors

## References

- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/citation-policy.md - Citation policy
- @.aiwg/research/docs/grade-assessment-guide.md - GRADE guide
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/citation-verifier.md - Verifier agent

Related Skills

eslint-checker

104
from jmagly/aiwg

Run ESLint for JavaScript/TypeScript code quality and style enforcement. Use for static analysis and auto-fixing.

verify-citations

104
from jmagly/aiwg

Verify all citations in a document against the research corpus

Codex

traceability-check

104
from jmagly/aiwg

Verify bidirectional traceability from requirements to code to tests and identify coverage gaps and orphan artifacts

Codex

regression-check

104
from jmagly/aiwg

Compare current behavior against baseline to detect regressions

Codex

quality-checker

104
from jmagly/aiwg

Validate skill quality, completeness, and adherence to standards. Use before packaging to ensure skill meets quality requirements.

Codex

project-health-check

104
from jmagly/aiwg

Analyze overall project health and metrics

Codex

link-check

104
from jmagly/aiwg

Verify @file references in AIWG skills and agents against the linking contract — per-file or corpus-wide, with optional auto-fix

Codex

flow-handoff-checklist

104
from jmagly/aiwg

Orchestrate handoff validation between SDLC phases and tracks (Discovery→Delivery, Delivery→Ops, phase transitions)

Codex

flow-gate-check

104
from jmagly/aiwg

Orchestrate SDLC phase gate validation with multi-agent review and comprehensive reporting

Codex

citation-guard

104
from jmagly/aiwg

Verify citations against the research corpus to prevent hallucinated references and enforce GRADE compliance

Codex

citation-backfill

104
from jmagly/aiwg

Rebuild bidirectional citation edges across the research corpus. Scans outgoing citation tables, computes the inverse map, and rewrites all incoming tables to match. Fixes one-directional citation graphs after batch inductions.

Codex

checkpoint

104
from jmagly/aiwg

Create, list, or recover mid-workflow checkpoints so interrupted work resumes from a known-good position

Codex