dongzhigang13305312738-art/paper-skills / bib-search-citation
bib-search-citation
VerifiedSearch 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.0 KB |
| agents/openai.yaml | config | 400 B |
| evals/evals.json | config | 4.4 KB |
| evals/trigger_eval.json | config | 2.9 KB |
| examples/compact-query.md | markdown | 830 B |
| examples/preview-summary.md | markdown | 717 B |
| examples/raw-bib-export.md | markdown | 666 B |
| references/limitations-and-errors.md | markdown | 2.6 KB |
| references/query-syntax.md | markdown | 8.9 KB |
| references/search-planning.md | markdown | 1.3 KB |
| scripts/preview_bib_search.py | script | 8.3 KB |
| scripts/search_bib.py | script | 48.7 KB |
| tests/fixtures/biblatex.bib | other | 464 B |
| tests/fixtures/broken.bib | other | 421 B |
| tests/fixtures/library.bib | other | 1.6 KB |
| tests/fixtures/phantom.bib | other | 514 B |
| tests/fixtures/preview_input.json | config | 1.5 KB |
| tests/fixtures/quote_trap.bib | other | 438 B |
| tests/test_bib_search.py | script | 21.0 KB |
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |