"` - `python3 $TOOLS_DIR/crossref.py bibliographic "<query>"` - `python3 $TOOLS_DIR/duplicates.py <file.bib>` - `python3 $TOOLS_DIR/edit.py <file.bib> <patches.json>` ## Patch Rules Use `edit.py` for all actual `.bib` changes. Do not edit the file directly with agent editing tools and do not rewrite the whole file. - `fix` patch: include `key`, `action`, `urls`, `explanation`, and `fields`; `entry_type` is optional. - In `fields`, set a field to `null` to remove it; omit a field to leave it unchanged. - `not_found`: comment out the original entry; do not add URL lines. - `duplicate`: add `% bibtidy: DUPLICATE of <other_key> — consider removing` above the original entry; no URL lines. - `review`: add one or more `% bibtidy: <URL>` lines plus `% bibtidy: REVIEW, <reason>` above the unchanged entry. - Clean entries get no comments. For `fix` patches, `edit.py` should produce: - fully commented original entry - one `% bibtidy: <URL>` line per source - one `% bibtidy: <explanation>` line - corrected entry Use source values verbatim. If the bib entry uses `and others` and a verified source provides the full author list, replace it with the full list. ## Workflow Each entry has a web-search budget of 1 total, used in at most one of Wave A or Wave B. 1. Read the file and note the path. 2. Clear the platform log: `> <file>.bib.cc.log` in Claude Code or `> <file>.bib.codex.log` in Codex. 3. Back up the file: `cp <file>.bib <file>.bib.orig` 4. Run `python3 $TOOLS_DIR/duplicates.py <file.bib>` before metadata fixes. 5. Run `python3 $TOOLS_DIR/compare.py <file.bib>` for CrossRef candidates. 6. Wave A web search: every entry with `error` set or no `candidates` must be web-verified. Those entries have spent their budget. 7. After each wave, classify every entry as one of: - `Clean`: confirmed, no changes - `Fix`: confident correction - `Escalate`: still ambiguous and budget unused - `Not found`: no paper found after required search - `Review`: budget spent and still uncertain 8. Wave B web search: only entries marked `Escalate` and not yet searched. After Wave B, final outcomes are only `Clean`, `Fix`, `Not found`, or `Review`. 9. Write a real `patches.json` file and apply fixes with `python3 $TOOLS_DIR/edit.py <file.bib> patches.json`. 10. Run `python3 $TOOLS_DIR/duplicates.py <file.bib>` again. Resolve every `unresolved same-key collisions` warning and rerun until the warning is gone. 11. Manually review likely related entries after fixes. Strong clues: repeated citation keys, repeated DOIs, same normalized title with overlapping authors, obvious preprint→published pairs. If two entries should be linked but not auto-removed, apply a `duplicate` patch. 12. Validate format, delete the backup, and print a summary table with rows: total entries, verified, fixed, not found, needs review, exact duplicates removed, near-duplicates flagged. For files with more than 30 entries, work in batches of about 15 and report progress. Entry count must match before and after. ## Compare Carefully `compare.py` returns raw CrossRef candidates plus `discrepancies`. Treat them as hints, not truth. - A missing candidate field is not evidence that the bib field should be removed. - If a verified candidate supplies a missing standard venue field such as volume, issue, or pages, add it. - Never add a `doi` field when the bib entry currently lacks one. - Treat `author` vs `authors` and `journal` vs `booktitle` as schema mismatches until verified. - If a preprint has a verified published version, update title, venue, year, volume, number, and pages together. - When the published title differs, replace the title verbatim; do not partially edit it. - Use `--` for BibTeX page ranges. - Missing `pages` is not automatically an error for venues that do not publish page numbers. ## Web Verification Use subagents when available; otherwise do the same work sequentially. Cap at 6 subagents per wave and distribute entries evenly. Each web-search subagent should return only JSON with: - `key` - `source_urls` - `fields` - `notes` Rules for subagents: - `fields` is either a fix-patch dict or `null`. - Use `null` inside `fields` to remove a stale field. - Verify against authoritative pages when possible: DOI page, publisher page, venue page, arXiv, OpenReview, etc. - Check title, full author list, year, journal/booktitle, volume, number/issue, pages, and DOI. - Put a value in `fields` when the verified source disagrees with the bib entry or when the bib entry is missing a standard field that the venue publishes. - Do not add a missing `doi` field just because you found one; mention it in `notes` if useful. - If a standard field is genuinely unavailable, say so in `notes`. ## Preserve - Entry order - All unchanged fields - Empty lines between entries - User `%` comments that are not `% bibtidy:` - `@string`, `@preamble`, and `@comment` blocks - LaTeX macros and brace-protected capitalization in titles If rate-limited, note it and continue with the next entry. 22:o64d,11:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@type\":\"SoftwareApplication\",\"name\":\"bibtidy\",\"description\":\"A bibliography toolkit for LaTeX\",\"applicationCategory\":\"Writing & language\",\"operatingSystem\":\"Claude\",\"url\":\"https://agentready.co/connectors/bibtidy\",\"sameAs\":[],\"publisher\":{\"@type\":\"Organization\",\"name\":\"mathpluscode\",\"url\":\"https://github.com\"}}"}}],["$","div",null,{"className":"wrap","children":[["$","div",null,{"className":"pp-head","children":[["$","$L23",null,{"name":"bibtidy","url":null,"size":56}],["$","div",null,{"children":[["$","div",null,{"className":"crumbs","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],[" / ",["$","$L5",null,{"href":"/categories/writing","children":"Writing & language"}]]]}],["$","h1",null,{"children":["bibtidy",null]}]]}]]}],["$","div",null,{"className":"pp","children":[["$","div",null,{"className":"ca","children":[["$","p",null,{"className":"tag","children":"A bibliography toolkit for LaTeX"}],null,["$","$L24",null,{"examples":[],"tools":[],"prefix":"","server":null,"instructions":[],"skills":[{"name":"bibtidy","label":"bibtidy","gist":"Use when the user wants to validate, check, or fix a BibTeX (.bib) reference file, wrong authors, stale arXiv preprints, incorrect metadata, duplicate entries, formatting issues","source":"https://github.com/mathpluscode/bibtidy/blob/a575d79a0fc3b33645f8e7d0cd02249e7159323f/skills/bibtidy/SKILL.md","raw":"$25"}],"skillNote":"1 in the Claude listing"}],null]}],"$L26"]}]]}]] 22:o902,1b:[["$","title","0",{"children":"bibtidy by mathpluscode: AI connector · Agent Ready"}],["$","meta","1",{"name":"description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","link","2",{"rel":"manifest","href":"/manifest.webmanifest","crossOrigin":"$undefined"}],["$","link","3",{"rel":"canonical","href":"https://agentready.co/connectors/bibtidy"}],["$","meta","4",{"property":"og:title","content":"bibtidy by mathpluscode: AI connector"}],["$","meta","5",{"property":"og:description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","meta","6",{"property":"og:url","content":"https://agentready.co/connectors/bibtidy"}],["$","meta","7",{"property":"og:site_name","content":"Agent Ready"}],["$","meta","8",{"property":"og:image","content":"https://agentready.co/connectors/bibtidy/opengraph-image?3b61e23efdbb5225"}],["$","meta","9",{"property":"og:image:type","content":"image/png"}],["$","meta","10",{"property":"og:image:width","content":"1200"}],["$","meta","11",{"property":"og:image:height","content":"630"}],["$","meta","12",{"property":"og:image:alt","content":"AI connector on Agent Ready"}],["$","meta","13",{"property":"og:type","content":"website"}],["$","meta","14",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","15",{"name":"twitter:title","content":"bibtidy by mathpluscode: AI connector"}],["$","meta","16",{"name":"twitter:description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","meta","17",{"name":"twitter:image","content":"https://agentready.co/connectors/bibtidy/opengraph-image?3b61e23efdbb5225"}],["$","meta","18",{"name":"twitter:image:alt","content":"AI connector on Agent Ready"}],["$","meta","19",{"name":"twitter:image:type","content":"image/png"}],["$","meta","20",{"name":"twitter:image:width","content":"1200"}],["$","meta","21",{"name":"twitter:image:height","content":"630"}],["$","link","22",{"rel":"icon","href":"/favicon.ico?favicon.3iymezf4ycw3e.ico","sizes":"64x64","type":"image/x-icon"}],["$","link","23",{"rel":"icon","href":"/icon.svg?icon.1m07wgr9jqhm5.svg","sizes":"any","type":"image/svg+xml"}],["$","link","24",{"rel":"apple-touch-icon","href":"/apple-icon.png?apple-icon.3q8qrgufoflqu.png","sizes":"180x180","type":"image/png"}],["$","$L27","25",{}]] 22:o10,1c:null 22:null 22:o22,:HL["/stores/claude.png","image"] 22:o12a6,26:["$","aside",null,{"className":"side","children":[["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Stores"}],["$","div",null,{"className":"st","children":[["$","div","claude",{"style":{"display":"contents"},"children":[["$","span",null,{"className":"s","children":[["$","img",null,{"className":"sm","src":"/stores/claude.png","alt":"","width":16,"height":16}],["$","b",null,{"children":"Claude"}],["$","a",null,{"className":"src","href":"https://github.com/mathpluscode/bibtidy","target":"_blank","rel":"noopener nofollow","children":"Source ↗"}]]}],["$","span",null,{"className":"rk2","children":[["$","small",null,{"children":"Listed, not ranked"}],null]}]]}]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Details"}],["$","dl",null,{"className":"kv","children":[[["$","dt",null,{"children":"Company"}],["$","dd",null,{"children":"mathpluscode"}]],[["$","dt",null,{"children":"Publisher"}],["$","dd",null,{"children":"Community"}]],["$","dt",null,{"children":"Category"}],["$","dd",null,{"children":["$","$L5",null,{"href":"/categories/writing","children":"Writing & language"}]}],[["$","dt",null,{"children":"Audience"}],["$","dd",null,{"children":"For business"}]],null,["$","dt",null,{"children":"Sign-in"}],["$","dd",null,{"children":"None needed"}],["$","dt",null,{"children":"Interactive UI"}],["$","dd",null,{"children":"No"}],[["$","dt",null,{"children":"Checked"}],["$","dd",null,{"children":"Oct 27, 2026"}]],null]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":["More in ","Writing & language"]}],["$","ul",null,{"className":"sim","children":[["$","li","15014",{"children":["$","$L5",null,{"href":"/connectors/rewritely-humanizer","prefetch":false,"children":[["$","$L23",null,{"name":"RewriteLy Humanizer","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/ff/fff77199e82753e100b2bd9304963e528545ca45bdc1be745d6316bb17b3e9a6-64.webp","size":24}],["$","b",null,{"children":"RewriteLy Humanizer"}],["$","small",null,{"children":"#231"}]]}]}],["$","li","15089",{"children":["$","$L5",null,{"href":"/connectors/ihate-ai-humanaizer","prefetch":false,"children":[["$","$L23",null,{"name":"IHate.ai Humanaizer","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/99/995b2b7bfdd0a3d83e95fb3c6a2eb43ddc27876e159cbbaea718ceff3c96546d-64.webp","size":24}],["$","b",null,{"children":"IHate.ai Humanaizer"}],["$","small",null,{"children":"#334"}]]}]}],["$","li","15094",{"children":["$","$L5",null,{"href":"/connectors/self-plagiarism-checker","prefetch":false,"children":[["$","$L23",null,{"name":"Self Plagiarism Checker","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/76/761422020f36b9682fafcabfdcb0f1a2c573042c7cae47a393b0937c6154eb46-64.webp","size":24}],["$","b",null,{"children":"Self Plagiarism Checker"}],["$","small",null,{"children":"#336"}]]}]}],["$","li","4438",{"children":["$","$L5",null,{"href":"/connectors/deepl","prefetch":false,"children":[["$","$L23",null,{"name":"DeepL","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/e6/e6668c741eab50959e2eb0ec4190036a8356b401b6e2a2ba1f72fc2375dcf33c-64.webp","size":24}],["$","b",null,{"children":"DeepL"}],["$","small",null,{"children":"#279"}]]}]}],["$","li","15150",{"children":["$","$L5",null,{"href":"/connectors/academic-writing-toolkit","prefetch":false,"children":[["$","$L23",null,{"name":"Academic Writing Toolkit","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/14/14c283d0502cd574ce5f104a1459f0d065d9a2ba385545fe682617ea9d43f17f-64.webp","size":24}],["$","b",null,{"children":"Academic Writing Toolkit"}],["$","small",null,{"children":"#374"}]]}]}],["$","li","4413",{"children":["$","$L5",null,{"href":"/connectors/idiolect","prefetch":false,"children":[["$","$L23",null,{"name":"Idiolect","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/43/435850acfa6dd01bcb21d5d3ae086fd0d1202798218809f01a6e18457446bf0b-64.webp","size":24}],["$","b",null,{"children":"Idiolect"}],["$","small",null,{"children":"#303"}]]}]}],["$","li","15289",{"children":["$","$L5",null,{"href":"/connectors/revise","prefetch":false,"children":[["$","$L23",null,{"name":"Revise","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/07/076b036f48f32c9239b7005832b58ba8bace6939a124c732e58282d1c0563a6e-64.webp","size":24}],["$","b",null,{"children":"Revise"}],["$","small",null,{"children":"#1,958"}]]}]}],["$","li","27534",{"children":["$","$L5",null,{"href":"/connectors/noveland-for-writers","prefetch":false,"children":["$L28","$L29","$L2a"]}]}]]}]]}]]}] 22:o147,28:["$","$L23",null,{"name":"NoveLand for Writers","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/8e/8e4f35bbfbfdecc408cbe05f4587c6497483a62d1975b67c80a4ec91ce96c858-64.webp","size":24}] 29:["$","b",null,{"children":"NoveLand for Writers"}] 2a:["$","small",null,{"children":"#1,981"}] 22:o11,20:false 1f:7027 22:o17,1e:C 1d:C 1:C 15:C b:C 22:C </article></body></html>

22:o1,#22:o643,2:"$Sreact.fragment" 3:"/_next/static/immutable/chunks/12yk9g49l7-7r.js" 4:"/_next/static/immutable/chunks/2jrhxdtf12-uf.js" 5:I[7575,["$3","$4"],""] 6:I[10291,["$3"],"default"] 7:I[2968,["$3"],"default"] 8:I[4098,["$3"],"WebMCP"] 9:I[57507,["$3"],"ExternalLinks"] a:I[93137,["$3"],"Analytics"] 10:"$Sreact.suspense" 16:"ViewportBoundary" 17:I[82520,["$3"],"$16"] 19:"MetadataBoundary" 1a:I[82520,["$3"],"$19"] :HL["/_next/static/immutable/chunks/3g2_9hnyt6p64.css","style"] 1:X b:X d:X 15:X f:[["children",{"s":"__PAGE__","h":49314,"d":{"r":["$","$2","c",{"children":[["$","$10",null,{"fallback":["$","div",null,{"className":"wrap","style":{"minHeight":"60vh"}}],"children":"$L11"}],["$L12","$L13"],"$L14"]}],"p":false,"v":"$15"}}]] e:[["children",{"s":{"n":"slug","t":"d","k":"bibtidy","s":[]},"h":49250,"d":{"r":["$","$2","c",{"children":[null,["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],"p":false,"v":"$d"},"c":"$Qf"}]] c:[["children",{"s":"connectors","h":49250,"d":{"r":["$","$2","c",{"children":[null,["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],"p":false,"v":"$d"},"c":"$Qe"}]] 1d:X 1e:X 22:o1232,0:{"q":"","i":false,"S":true,"r":"$1","t":{"t":{"s":"","h":49234,"d":{"r":["$","$2","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/3g2_9hnyt6p64.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/immutable/chunks/12yk9g49l7-7r.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"en","className":"ec5Qua_variable","children":["$","body",null,{"children":[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://agentready.co/#org\",\"name\":\"Agent Ready\",\"url\":\"https://agentready.co/\",\"logo\":\"https://agentready.co/icon-512.png\"},{\"@type\":\"WebSite\",\"@id\":\"https://agentready.co/#site\",\"name\":\"Agent Ready\",\"url\":\"https://agentready.co/\",\"publisher\":{\"@id\":\"https://agentready.co/#org\"}}]}"}}],["$","header",null,{"className":"site","children":["$","div",null,{"className":"wrap","children":[["$","$L5",null,{"href":"/","className":"brand","children":[["$","svg",null,{"className":"brand-mark","viewBox":"0 0 64 64","aria-hidden":"true","children":[["$","defs",null,{"children":["$","linearGradient",null,{"id":"arg","x1":"0","y1":"1","x2":"1","y2":"0","children":[["$","stop",null,{"offset":"0","stopColor":"#2563EB"}],["$","stop",null,{"offset":"1","stopColor":"#06B6D4"}]]}]}],["$","path",null,{"d":"M9 55 L32 9 L55 55","fill":"none","stroke":"url(#arg)","strokeWidth":"11","strokeLinecap":"round","strokeLinejoin":"round"}],["$","circle",null,{"cx":"32","cy":"45","r":"7","fill":"#FACC15"}]]}],"Agent Ready"]}],["$","nav",null,{"aria-label":"Main","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],["$","$L5",null,{"href":"/categories","className":"nv-x","children":"Categories"}],["$","$L5",null,{"href":"/blog","children":"Blog"}],["$","$L5",null,{"href":"/mcp-plugin-usage","className":"nv-x","children":"Usage"}],["$","$L5",null,{"href":"/methodology","className":"nv-x","children":"Methodology"}],["$","$L5",null,{"href":"/work-with-us","className":"nv-cta","children":"Work with us"}]]}]]}]}],["$","main",null,{"children":["$","$L6",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L7",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":{"fontFamily":"system-ui,\"Segoe UI\",Roboto,Helvetica,Arial,sans-serif,\"Apple Color Emoji\",\"Segoe UI Emoji\"","height":"100vh","textAlign":"center","display":"flex","flexDirection":"column","alignItems":"center","justifyContent":"center"},"children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":{"display":"inline-block","margin":"0 20px 0 0","padding":"0 23px 0 0","fontSize":24,"fontWeight":500,"verticalAlign":"top","lineHeight":"49px"},"children":404}],["$","div",null,{"style":{"display":"inline-block"},"children":["$","h2",null,{"style":{"fontSize":14,"fontWeight":400,"lineHeight":"49px","margin":0},"children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]}],["$","$L8",null,{}],["$","$L9",null,{}],["$","$La",null,{}],["$","footer",null,{"className":"foot","children":["$","div",null,{"className":"wrap","children":[["$","span",null,{"children":"Agent Ready"}],["$","nav",null,{"aria-label":"Footer","children":[["$","$L5",null,{"href":"/blog","children":"Blog"}],["$","$L5",null,{"href":"/mcp-plugin-usage","children":"Usage"}],["$","$L5",null,{"href":"/methodology","children":"Methodology"}],["$","$L5",null,{"href":"/categories","children":"Categories"}],["$","a",null,{"href":"/llms.txt","children":"llms.txt"}],["$","a",null,{"href":"/sitemap.xml","children":"Sitemap"}],["$","$L5",null,{"href":"/work-with-us","children":"Work with us"}]]}]]}]}]]}]}]]}],"p":false,"v":"$b"},"c":"$Qc"},"h":{"r":["$","$2","h",{"children":[null,["$","$L17","z5BiY3TM6sssF3HTlkzgkv",{"children":"$L18"}],["$","$L1a","z5BiY3TM6sssF3HTlkzgkm",{"children":[["$","div",null,{"hidden":true,"children":["$","$10",null,{"name":"Next.Metadata","children":"$L1b"}]}],"$L1c"]}]]}],"p":false,"v":"$1d"}},"s":"$1e","a":"$@1f","w":"$@20"} 22:o1b1,21:I[82520,["$3"],"OutletBoundary"] :HL["/_next/static/immutable/chunks/2lo4itc7piqdu.css","style"] d:C 12:["$","link","0",{"rel":"stylesheet","href":"/_next/static/immutable/chunks/2lo4itc7piqdu.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}] 13:["$","script","script-0",{"src":"/_next/static/immutable/chunks/2jrhxdtf12-uf.js","async":true,"nonce":"$undefined"}] 14:["$","$L21",null,{"children":"$@22"}] 22:o14d,1e:300 18:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}],["$","meta","2",{"name":"theme-color","content":"#ffffff","media":"(prefers-color-scheme: light)"}],["$","meta","3",{"name":"theme-color","content":"#0d0d0f","media":"(prefers-color-scheme: dark)"}]] 22:o25,1d:0 15:0 15:T4,slug1d:T4,slug1e:300 22:o68,23:I[37521,["$3","$4"],"Logo"] 24:I[53913,["$3","$4"],"Explore"] 27:I[60329,["$3"],"IconMark"] 25:T18ad,22:o18ad,--- name: bibtidy description: Use when the user wants to validate, check, or fix a BibTeX (.bib) reference file, wrong authors, stale arXiv preprints, incorrect metadata, duplicate entries, formatting issues metadata: short-description: Validate and fix BibTeX reference files allowed-tools: Bash(python3 *), Bash(cp *), Bash(rm *), Read, Agent, WebSearch --- Use this skill for any request to validate, check, clean up, or fix a BibTeX `.bib` file. If the request includes a `.bib` path, operate on it. If the path is missing or does not exist, ask for it. Assumptions: - Process entries one by one. - Only brace-style BibTeX like `@article{...}` is supported; reject parenthesized `@article(...)`. - Preserve `@string`, `@preamble`, and `@comment` blocks verbatim. ## Resolve Tools All bundled scripts live in `tools/` next to this file. Resolve `TOOLS_DIR` once: ```bash for d in \ "${CODEX_HOME:-$HOME/.codex}/skills/bibtidy/tools" \ "$HOME/.claude/skills/bibtidy/tools" \ "${CLAUDE_PLUGIN_ROOT:-/dev/null}/skills/bibtidy/tools"; do [ -f "$d/crossref.py" ] && TOOLS_DIR="$d" && break done ``` Useful commands: - `python3 $TOOLS_DIR/compare.py [--key KEY]` - `python3 $TOOLS_DIR/crossref.py doi ` - `python3 $TOOLS_DIR/crossref.py search ""` - `python3 $TOOLS_DIR/crossref.py bibliographic "<query>"` - `python3 $TOOLS_DIR/duplicates.py <file.bib>` - `python3 $TOOLS_DIR/edit.py <file.bib> <patches.json>` ## Patch Rules Use `edit.py` for all actual `.bib` changes. Do not edit the file directly with agent editing tools and do not rewrite the whole file. - `fix` patch: include `key`, `action`, `urls`, `explanation`, and `fields`; `entry_type` is optional. - In `fields`, set a field to `null` to remove it; omit a field to leave it unchanged. - `not_found`: comment out the original entry; do not add URL lines. - `duplicate`: add `% bibtidy: DUPLICATE of <other_key> — consider removing` above the original entry; no URL lines. - `review`: add one or more `% bibtidy: <URL>` lines plus `% bibtidy: REVIEW, <reason>` above the unchanged entry. - Clean entries get no comments. For `fix` patches, `edit.py` should produce: - fully commented original entry - one `% bibtidy: <URL>` line per source - one `% bibtidy: <explanation>` line - corrected entry Use source values verbatim. If the bib entry uses `and others` and a verified source provides the full author list, replace it with the full list. ## Workflow Each entry has a web-search budget of 1 total, used in at most one of Wave A or Wave B. 1. Read the file and note the path. 2. Clear the platform log: `> <file>.bib.cc.log` in Claude Code or `> <file>.bib.codex.log` in Codex. 3. Back up the file: `cp <file>.bib <file>.bib.orig` 4. Run `python3 $TOOLS_DIR/duplicates.py <file.bib>` before metadata fixes. 5. Run `python3 $TOOLS_DIR/compare.py <file.bib>` for CrossRef candidates. 6. Wave A web search: every entry with `error` set or no `candidates` must be web-verified. Those entries have spent their budget. 7. After each wave, classify every entry as one of: - `Clean`: confirmed, no changes - `Fix`: confident correction - `Escalate`: still ambiguous and budget unused - `Not found`: no paper found after required search - `Review`: budget spent and still uncertain 8. Wave B web search: only entries marked `Escalate` and not yet searched. After Wave B, final outcomes are only `Clean`, `Fix`, `Not found`, or `Review`. 9. Write a real `patches.json` file and apply fixes with `python3 $TOOLS_DIR/edit.py <file.bib> patches.json`. 10. Run `python3 $TOOLS_DIR/duplicates.py <file.bib>` again. Resolve every `unresolved same-key collisions` warning and rerun until the warning is gone. 11. Manually review likely related entries after fixes. Strong clues: repeated citation keys, repeated DOIs, same normalized title with overlapping authors, obvious preprint→published pairs. If two entries should be linked but not auto-removed, apply a `duplicate` patch. 12. Validate format, delete the backup, and print a summary table with rows: total entries, verified, fixed, not found, needs review, exact duplicates removed, near-duplicates flagged. For files with more than 30 entries, work in batches of about 15 and report progress. Entry count must match before and after. ## Compare Carefully `compare.py` returns raw CrossRef candidates plus `discrepancies`. Treat them as hints, not truth. - A missing candidate field is not evidence that the bib field should be removed. - If a verified candidate supplies a missing standard venue field such as volume, issue, or pages, add it. - Never add a `doi` field when the bib entry currently lacks one. - Treat `author` vs `authors` and `journal` vs `booktitle` as schema mismatches until verified. - If a preprint has a verified published version, update title, venue, year, volume, number, and pages together. - When the published title differs, replace the title verbatim; do not partially edit it. - Use `--` for BibTeX page ranges. - Missing `pages` is not automatically an error for venues that do not publish page numbers. ## Web Verification Use subagents when available; otherwise do the same work sequentially. Cap at 6 subagents per wave and distribute entries evenly. Each web-search subagent should return only JSON with: - `key` - `source_urls` - `fields` - `notes` Rules for subagents: - `fields` is either a fix-patch dict or `null`. - Use `null` inside `fields` to remove a stale field. - Verify against authoritative pages when possible: DOI page, publisher page, venue page, arXiv, OpenReview, etc. - Check title, full author list, year, journal/booktitle, volume, number/issue, pages, and DOI. - Put a value in `fields` when the verified source disagrees with the bib entry or when the bib entry is missing a standard field that the venue publishes. - Do not add a missing `doi` field just because you found one; mention it in `notes` if useful. - If a standard field is genuinely unavailable, say so in `notes`. ## Preserve - Entry order - All unchanged fields - Empty lines between entries - User `%` comments that are not `% bibtidy:` - `@string`, `@preamble`, and `@comment` blocks - LaTeX macros and brace-protected capitalization in titles If rate-limited, note it and continue with the next entry. 22:o64d,11:[["$","script",null,{"type":"application/ld+json","dangerouslySetInnerHTML":{"__html":"{\"@context\":\"https://schema.org\",\"@type\":\"SoftwareApplication\",\"name\":\"bibtidy\",\"description\":\"A bibliography toolkit for LaTeX\",\"applicationCategory\":\"Writing & language\",\"operatingSystem\":\"Claude\",\"url\":\"https://agentready.co/connectors/bibtidy\",\"sameAs\":[],\"publisher\":{\"@type\":\"Organization\",\"name\":\"mathpluscode\",\"url\":\"https://github.com\"}}"}}],["$","div",null,{"className":"wrap","children":[["$","div",null,{"className":"pp-head","children":[["$","$L23",null,{"name":"bibtidy","url":null,"size":56}],["$","div",null,{"children":[["$","div",null,{"className":"crumbs","children":[["$","$L5",null,{"href":"/","children":"Connectors"}],[" / ",["$","$L5",null,{"href":"/categories/writing","children":"Writing & language"}]]]}],["$","h1",null,{"children":["bibtidy",null]}]]}]]}],["$","div",null,{"className":"pp","children":[["$","div",null,{"className":"ca","children":[["$","p",null,{"className":"tag","children":"A bibliography toolkit for LaTeX"}],null,["$","$L24",null,{"examples":[],"tools":[],"prefix":"","server":null,"instructions":[],"skills":[{"name":"bibtidy","label":"bibtidy","gist":"Use when the user wants to validate, check, or fix a BibTeX (.bib) reference file, wrong authors, stale arXiv preprints, incorrect metadata, duplicate entries, formatting issues","source":"https://github.com/mathpluscode/bibtidy/blob/a575d79a0fc3b33645f8e7d0cd02249e7159323f/skills/bibtidy/SKILL.md","raw":"$25"}],"skillNote":"1 in the Claude listing"}],null]}],"$L26"]}]]}]] 22:o902,1b:[["$","title","0",{"children":"bibtidy by mathpluscode: AI connector · Agent Ready"}],["$","meta","1",{"name":"description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","link","2",{"rel":"manifest","href":"/manifest.webmanifest","crossOrigin":"$undefined"}],["$","link","3",{"rel":"canonical","href":"https://agentready.co/connectors/bibtidy"}],["$","meta","4",{"property":"og:title","content":"bibtidy by mathpluscode: AI connector"}],["$","meta","5",{"property":"og:description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","meta","6",{"property":"og:url","content":"https://agentready.co/connectors/bibtidy"}],["$","meta","7",{"property":"og:site_name","content":"Agent Ready"}],["$","meta","8",{"property":"og:image","content":"https://agentready.co/connectors/bibtidy/opengraph-image?3b61e23efdbb5225"}],["$","meta","9",{"property":"og:image:type","content":"image/png"}],["$","meta","10",{"property":"og:image:width","content":"1200"}],["$","meta","11",{"property":"og:image:height","content":"630"}],["$","meta","12",{"property":"og:image:alt","content":"AI connector on Agent Ready"}],["$","meta","13",{"property":"og:type","content":"website"}],["$","meta","14",{"name":"twitter:card","content":"summary_large_image"}],["$","meta","15",{"name":"twitter:title","content":"bibtidy by mathpluscode: AI connector"}],["$","meta","16",{"name":"twitter:description","content":"A bibliography toolkit for LaTeX. Available in Claude."}],["$","meta","17",{"name":"twitter:image","content":"https://agentready.co/connectors/bibtidy/opengraph-image?3b61e23efdbb5225"}],["$","meta","18",{"name":"twitter:image:alt","content":"AI connector on Agent Ready"}],["$","meta","19",{"name":"twitter:image:type","content":"image/png"}],["$","meta","20",{"name":"twitter:image:width","content":"1200"}],["$","meta","21",{"name":"twitter:image:height","content":"630"}],["$","link","22",{"rel":"icon","href":"/favicon.ico?favicon.3iymezf4ycw3e.ico","sizes":"64x64","type":"image/x-icon"}],["$","link","23",{"rel":"icon","href":"/icon.svg?icon.1m07wgr9jqhm5.svg","sizes":"any","type":"image/svg+xml"}],["$","link","24",{"rel":"apple-touch-icon","href":"/apple-icon.png?apple-icon.3q8qrgufoflqu.png","sizes":"180x180","type":"image/png"}],["$","$L27","25",{}]] 22:o10,1c:null 22:null 22:o22,:HL["/stores/claude.png","image"] 22:o12a6,26:["$","aside",null,{"className":"side","children":[["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Stores"}],["$","div",null,{"className":"st","children":[["$","div","claude",{"style":{"display":"contents"},"children":[["$","span",null,{"className":"s","children":[["$","img",null,{"className":"sm","src":"/stores/claude.png","alt":"","width":16,"height":16}],["$","b",null,{"children":"Claude"}],["$","a",null,{"className":"src","href":"https://github.com/mathpluscode/bibtidy","target":"_blank","rel":"noopener nofollow","children":"Source ↗"}]]}],["$","span",null,{"className":"rk2","children":[["$","small",null,{"children":"Listed, not ranked"}],null]}]]}]]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":"Details"}],["$","dl",null,{"className":"kv","children":[[["$","dt",null,{"children":"Company"}],["$","dd",null,{"children":"mathpluscode"}]],[["$","dt",null,{"children":"Publisher"}],["$","dd",null,{"children":"Community"}]],["$","dt",null,{"children":"Category"}],["$","dd",null,{"children":["$","$L5",null,{"href":"/categories/writing","children":"Writing & language"}]}],[["$","dt",null,{"children":"Audience"}],["$","dd",null,{"children":"For business"}]],null,["$","dt",null,{"children":"Sign-in"}],["$","dd",null,{"children":"None needed"}],["$","dt",null,{"children":"Interactive UI"}],["$","dd",null,{"children":"No"}],[["$","dt",null,{"children":"Checked"}],["$","dd",null,{"children":"Oct 27, 2026"}]],null]}]]}],["$","div",null,{"className":"card","children":[["$","h2",null,{"children":["More in ","Writing & language"]}],["$","ul",null,{"className":"sim","children":[["$","li","15014",{"children":["$","$L5",null,{"href":"/connectors/rewritely-humanizer","prefetch":false,"children":[["$","$L23",null,{"name":"RewriteLy Humanizer","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/ff/fff77199e82753e100b2bd9304963e528545ca45bdc1be745d6316bb17b3e9a6-64.webp","size":24}],["$","b",null,{"children":"RewriteLy Humanizer"}],["$","small",null,{"children":"#231"}]]}]}],["$","li","15089",{"children":["$","$L5",null,{"href":"/connectors/ihate-ai-humanaizer","prefetch":false,"children":[["$","$L23",null,{"name":"IHate.ai Humanaizer","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/99/995b2b7bfdd0a3d83e95fb3c6a2eb43ddc27876e159cbbaea718ceff3c96546d-64.webp","size":24}],["$","b",null,{"children":"IHate.ai Humanaizer"}],["$","small",null,{"children":"#334"}]]}]}],["$","li","15094",{"children":["$","$L5",null,{"href":"/connectors/self-plagiarism-checker","prefetch":false,"children":[["$","$L23",null,{"name":"Self Plagiarism Checker","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/76/761422020f36b9682fafcabfdcb0f1a2c573042c7cae47a393b0937c6154eb46-64.webp","size":24}],["$","b",null,{"children":"Self Plagiarism Checker"}],["$","small",null,{"children":"#336"}]]}]}],["$","li","4438",{"children":["$","$L5",null,{"href":"/connectors/deepl","prefetch":false,"children":[["$","$L23",null,{"name":"DeepL","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/e6/e6668c741eab50959e2eb0ec4190036a8356b401b6e2a2ba1f72fc2375dcf33c-64.webp","size":24}],["$","b",null,{"children":"DeepL"}],["$","small",null,{"children":"#279"}]]}]}],["$","li","15150",{"children":["$","$L5",null,{"href":"/connectors/academic-writing-toolkit","prefetch":false,"children":[["$","$L23",null,{"name":"Academic Writing Toolkit","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/14/14c283d0502cd574ce5f104a1459f0d065d9a2ba385545fe682617ea9d43f17f-64.webp","size":24}],["$","b",null,{"children":"Academic Writing Toolkit"}],["$","small",null,{"children":"#374"}]]}]}],["$","li","4413",{"children":["$","$L5",null,{"href":"/connectors/idiolect","prefetch":false,"children":[["$","$L23",null,{"name":"Idiolect","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/43/435850acfa6dd01bcb21d5d3ae086fd0d1202798218809f01a6e18457446bf0b-64.webp","size":24}],["$","b",null,{"children":"Idiolect"}],["$","small",null,{"children":"#303"}]]}]}],["$","li","15289",{"children":["$","$L5",null,{"href":"/connectors/revise","prefetch":false,"children":[["$","$L23",null,{"name":"Revise","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/07/076b036f48f32c9239b7005832b58ba8bace6939a124c732e58282d1c0563a6e-64.webp","size":24}],["$","b",null,{"children":"Revise"}],["$","small",null,{"children":"#1,958"}]]}]}],["$","li","27534",{"children":["$","$L5",null,{"href":"/connectors/noveland-for-writers","prefetch":false,"children":["$L28","$L29","$L2a"]}]}]]}]]}]]}] 22:o147,28:["$","$L23",null,{"name":"NoveLand for Writers","url":"https://bodgzvrssuydrdmsrqsh.supabase.co/storage/v1/object/public/listing-media/v/8e/8e4f35bbfbfdecc408cbe05f4587c6497483a62d1975b67c80a4ec91ce96c858-64.webp","size":24}] 29:["$","b",null,{"children":"NoveLand for Writers"}] 2a:["$","small",null,{"children":"#1,981"}] 22:o11,20:false 1f:7027 22:o17,1e:C 1d:C 1:C 15:C b:C 22:C </article></body></html>

bibtidy

Skills

bibtidy

Skills