/verify-refs — Reference Authenticity Check
Running Python helpers
Choose the interpreter before running the examples. For a globally installed
copy, use the private runtime recorded by its installer. In a checkout or linked
workspace, use AWT_PYTHON when set, otherwise the toolkit's .venv (follow the
skill directory link back to the toolkit): Scripts/python.exe on Windows,
bin/python on macOS/Linux. Without that environment, check that python
(Windows) or python3 (macOS/Linux) actually runs and has the helper's dependencies.
Replace the example's python3 with that executable. In PowerShell, prefix a
quoted executable with &; keep commands on one line and quote file paths.
Purpose
Check reference records for missing required fields, duplicate keys, malformed DOI values, malformed arXiv identifiers, and invalid URLs. The default mode is offline and deterministic.
Trigger Words
This skill activates on: verify refs, verify references, reference check, /verify-refs.
Workflow
- Identify the target Markdown or
.bib file. If the user does not specify one, ask.
- Run:
python3 .claude/skills/verify-refs/scripts/verify-refs.py --bib "{path}" --json
- Report issues by entry key and severity.
- For explicit metadata verification, run:
python3 .claude/skills/verify-refs/scripts/verify-refs.py --bib "{path}" --json --online
- Use CrossRef for DOI metadata, Semantic Scholar as a secondary metadata source, and arXiv for preprint identifiers. Online checks must be explicit because they depend on network availability.
- In tests or offline review, use
--metadata-dir "{dir}" to read CrossRef JSON, Semantic Scholar JSON, and arXiv Atom fixtures instead of live network calls.
Constraints
- Do not import project-specific reference rules from other repositories.
- Do not auto-fix reference records without user approval.
- Keep output plain Markdown with no emoji.
- Treat CrossRef, Semantic Scholar, and arXiv as verification sources, not as citation style authorities.
1---2name: verify-refs3description: Use when checking BibTeX reference records for missing fields, malformed identifiers, duplicate keys, or metadata mismatches before submission.4---56# /verify-refs — Reference Authenticity Check78## Running Python helpers910Choose the interpreter before running the examples. For a globally installed11copy, use the private runtime recorded by its installer. In a checkout or linked12workspace, use `AWT_PYTHON` when set, otherwise the toolkit's `.venv` (follow the13skill directory link back to the toolkit): `Scripts/python.exe` on Windows,14`bin/python` on macOS/Linux. Without that environment, check that `python`15(Windows) or `python3` (macOS/Linux) actually runs and has the helper's dependencies.16Replace the example's `python3` with that executable. In PowerShell, prefix a17quoted executable with `&`; keep commands on one line and quote file paths.1819## Purpose2021Check reference records for missing required fields, duplicate keys, malformed DOI values, malformed arXiv identifiers, and invalid URLs. The default mode is offline and deterministic.2223## Trigger Words2425This skill activates on: `verify refs`, `verify references`, `reference check`, `/verify-refs`.2627## Workflow28291. Identify the target Markdown or `.bib` file. If the user does not specify one, ask.302. Run:31 `python3 .claude/skills/verify-refs/scripts/verify-refs.py --bib "{path}" --json`323. Report issues by entry key and severity.334. For explicit metadata verification, run:34 `python3 .claude/skills/verify-refs/scripts/verify-refs.py --bib "{path}" --json --online`355. Use CrossRef for DOI metadata, Semantic Scholar as a secondary metadata source, and arXiv for preprint identifiers. Online checks must be explicit because they depend on network availability.366. In tests or offline review, use `--metadata-dir "{dir}"` to read CrossRef JSON, Semantic Scholar JSON, and arXiv Atom fixtures instead of live network calls.3738## Constraints39401. Do not import project-specific reference rules from other repositories.412. Do not auto-fix reference records without user approval.423. Keep output plain Markdown with no emoji.434. Treat CrossRef, Semantic Scholar, and arXiv as verification sources, not as citation style authorities.
yha9806