Skip to content

dongzhigang13305312738-art/paper-skills / bib-search-citation

bib-search-citation

Verified

Search and cite from local BibTeX/BibLaTeX .bib libraries, including Zotero exports. Use to find, filter, preview, export, or generate LaTeX/Typst citation snippets by topic, author, year, venue, DOI, arXiv ID, keywords, abstract, fields, recency, or claim support. Do not use for manuscript writing or polishing.

references/limitations-and-errors.md

View on GitHub
# Known Limitations and Error Handling

## Known limitations

These are documented so results are reported honestly, not silently:

- **Author matching** is a case-insensitive, accent-folded substring test on the
  raw author string. It does not normalise name order, so `author:"Jane Doe"`
  will not match a `{Doe, Jane}` field; search by surname (`author:Doe`) instead.
  Substring matching also means `author:chen` matches both `Chen` and `Cheng` —
  convenient, but verify the author before citing.
- **`matched_entries`** counts entries that pass the structured filters; it does
  not reflect how many were dropped by the free-text relevance threshold.
- **CJK multi-keyword** queries match best as a contiguous substring
  (`时间序列`); space-separated CJK terms may not all match.
- **Multi-file libraries** are not merged automatically — run the script once per
  `.bib` file. The `meta.parse_warnings` list reports parsing problems: entries
  skipped over a structural defect such as a missing closing brace, duplicate
  citation keys (each affected result also carries a `warnings` field), and
  entries sitting behind a `%` marker, which real BibTeX still parses.
- **`has:code` is a word-boundary heuristic**, not a semantic classifier. It
  avoids substring matches such as `reported`, `encoder`, and `barcode`, but it
  does not understand negation (`without a linked repository` still matches) or
  reject generic phrases such as `dress code`.
- **Unbalanced compact-query quotes** trigger a tokenizer fallback instead of an
  error. Double-quoted phrases still group, while single quotes are treated as
  literal characters; the fallback is reported as `query_tokenizer_fallback` in
  `meta.parse_warnings`.
- **Year disambiguation suffixes** accept one lowercase ASCII letter, so `2024a`
  is filtered as year 2024. Longer or uppercase suffixes are not interpreted as
  BibTeX year disambiguation markers.

## Error handling

### Parse errors

If a `.bib` file contains malformed entries, the script processes the valid
entries it can parse. When unexpectedly few entries are returned, inspect the
file encoding and look for obvious structural corruption such as missing closing
braces.

### Empty result sets

When zero entries match, suggest broadening the search in this order:

1. remove `has:` constraints such as `has:code`
2. widen or remove the year range
3. use fewer or shorter topic keywords
4. check author spelling or try partial-name matches

### Large files

The helper scripts use linear scans and no external parser dependency. For very
large libraries, expect proportionally longer runtime but the same JSON contract.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall