Verify refs
Skill yha9806/academic-writing-toolkit/plugins/academic-writing-toolkit/skills/verify-refs
Use when checking BibTeX reference records for missing fields, malformed identifiers, duplicate keys, or metadata mismatches before submission.From its SKILL.md
npx -y skills add yha9806/academic-writing-toolkit --skill verify-refsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- runs commandsInstructs the agent to run 2 commands, including `python3 {skill_dir}/scripts/verify-refs.py --bib {path} --json` and 1 more.
SKILL.md
1.7 KB, 329 tokens by cl100k_base, as published. Nobody here has run it
/verify-refs — Reference Authenticity Check
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
.bibfile. If the user does not specify one, ask. - Resolve the bundled helper at
scripts/verify-refs.pyrelative to thisSKILL.md, then run it from the project root:python3 {skill_dir}/scripts/verify-refs.py --bib {path} --json - Report issues by entry key and severity.
- For explicit metadata verification, run:
python3 {skill_dir}/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.
What ships with it: 1 file
15.0 KB alongside SKILL.md, 1 of them executable
scripts/
- verify-refs.pyruns15.0 KB