Agent skill

Bib Coverage

by flonat in flonat/flonat-research

Compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.

MITAuto-check passedResearch & Science

Install Bib Coverage

skills CLI
$ npx skills add flonat/flonat-research --skill bib-coverage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research bib-coverage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bib-coverage .claude/skills/bib-coverage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bib-coverage
GitHub stars
145
Token cost
~1.4k tokens
SKILL.md length
613 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.

  • Works in 5 steps: Load Project Bibliography → Load Paperpile Folder → Compare → …
  • The user asks to compare a project .bib against a Paperpile project/topic folder to find uncited papers
  • SKILL.md covers When to Use, When NOT to Use, Inputs and Workflow, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bib Coverage is an agent skill from flonat/flonat-research. Compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries. Use when the user asks to compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Citation management. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The user asks to compare a project .bib against a Paperpile project/topic folder to find uncited papers
  • Unfiled entries

Example prompts

  • “/bib-coverage”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash(paperpile*)

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Load Project Bibliography
  2. Load Paperpile Folder
  3. Compare
  4. Coverage Stats
  5. Recommendations

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Bash(paperpile*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bib Coverage loads about 1.4k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 613 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 613 words, ~1,411 tokens.

Download SKILL.mdSave it as .claude/skills/bib-coverage/SKILL.md (or your agent's skills folder).
name
bib-coverage
description
Compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries. Use when the user asks to compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.
allowed-tools
Read, Glob, Grep, Bash(paperpile*)
argument-hint
[project-path or tex-file]

Bibliography Coverage

LIBRARY-FIRST RULE: ALWAYS check Paperpile (paperpile search-library) when assessing coverage.

Compare a project's .bib file against a Paperpile project/topic folder to identify gaps between the project bibliography and the reference library.

When to Use

  • After a literature search, to see what % of the topic collection is cited
  • Before submitting a paper, to catch references you forgot to cite
  • When reviewing a Paperpile project/topic folder, to find items not yet in any project's .bib
  • After a bibliography-quality check, as a complementary completeness check

When NOT to Use

  • Finding new references — use an installed literature-discovery workflow or scholarly search
  • Validating .bib quality (missing fields, DOI issues, preprint staleness) — use an installed bibliography validator
  • Building a .bib from scratch — use bib-parse or an installed literature workflow

Inputs

  1. Project .bib file — detected automatically (same logic as bib-validate: look for references.bib, then any .bib in the project)
  2. Paperpile folder — resolved from:
    • Explicit --topic <slug> argument
    • Project's CLAUDE.md or Atlas topic frontmatter
    • Directory name if inside a research project
    • If no collection can be resolved, report an error and suggest specifying --topic

Workflow

1. Load Project Bibliography

Parse the .bib file to extract all entry keys and titles.

2. Load Paperpile Folder
  1. Call paperpile get-folders to find the relevant full topic path
  2. Call paperpile get-items-by-folder "<full path>" to get items in that folder
  3. Extract item keys (citekey) and titles

Paperpile's labelsNamed and foldersNamed are distinct. Project/topic collections use folders. If a leaf occurs under multiple parents, stop and request or derive the full path; never silently choose one.

Graceful degradation: If the paperpile CLI is unavailable, skip with a warning — report .bib-only stats.

3. Compare

Produce three lists:

CategoryDescriptionAction
Cited + In FolderItems in both .bib and the Paperpile folderNo action — healthy
Cited but Not in FolderItems in .bib but not in the Paperpile folderNeeds filing in Paperpile
In Folder but Not CitedItems in the Paperpile folder but not cited in any .texPotential references — review for inclusion
4. Coverage Stats
## Coverage Report

**Paperpile folder:** [full path] ([N] items)
**Project .bib:** [M] entries

| Metric | Count | % |
|--------|-------|---|
| Cited + In Folder | X | X/N |
| Cited but Not Filed | Y | — |
| In Folder, Not Cited | Z | Z/N |
| Coverage (cited/folder) | — | X/N% |
5. Recommendations

Based on the results:

  • Low coverage (<50%): "The project cites few papers from the topic collection. Consider reviewing uncited items for relevance."
  • Many unfiled citations (>5): "Several cited papers aren't in the topic collection. Reconcile them with the configured reference manager."
  • High coverage (>80%): "Good coverage of the topic collection."
Show full SKILL.md (223 more words)Show less

Report Format

## bib-coverage: [Project Name]

**Topic:** [slug] | **Collection:** [name] ([N] items) | **Bib:** [filename] ([M] entries)

### Coverage: X/N (XX%)

### Cited but Not in Collection (need filing)
| # | Key | Title | Year |
|---|-----|-------|------|

### In Collection but Not Cited (potential references)
| # | Key | Title | Year |
|---|-----|-------|------|

Phase 6 (Optional): Gap Discovery via Recommendations

When coverage is low (<50%) or the user says "find what I'm missing", use the S2 Recommendations API to discover papers that should be in the collection but aren't.

  1. Select seed papers — pick the 3-5 most-cited papers from the .bib file
  2. Get recommendations — run scholarly scholarly-similar-works <paper_id> --json for each seed paper to get ML-based similar paper suggestions
  3. Filter against existing — remove papers already in the .bib or Paperpile folder
  4. Rank by relevance — sort by citation count and recency
  5. Present candidates — show a table of recommended additions with titles, years, citation counts

Dispatch rule. If ≥5 seed papers are selected, dispatch a single Explore sub-agent that runs scholarly scholarly-similar-works for each seed and writes merged candidates to /tmp/bib-coverage-similar.json. Main context reads only the merged result. For 3–4 seeds, inline calls are fine. See _shared/cli-dispatch-policy.md.

This turns a passive coverage check into an active discovery tool — finding papers the researcher should know about based on what they already cite.

Cross-References

  • Installed bibliography validator — Quality validation (missing fields, DOIs, preprints). Run alongside coverage for a complete check.
  • Installed literature workflow — Discovery of new references. Coverage identifies gaps in existing collections.
  • bib-parse — Extract citations from PDFs. Run coverage after parsing to see overlap with the topic collection.
  • shared/reference-resolution.md — Topic collection resolution logic

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/bib-coverage of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Bib Coverage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bib Coverage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bib Coverage this skillflonat/flonat-research145—~1.4kAutomated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
NetworkxzLanqing/codex-claude-academic-skills4.6k16 repos~3.2kAutomated safety check: PassBSD-3-Clause
Citation Verification GuideGalaxy-Dawn/claude-scholar5.7k3 repos~1.9kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.6k GitHub starsUsed in 16 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 3 repos~1.9k tokens
    Research & ScienceAuto-check passed
  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 13 repos~3k tokens
    Research & ScienceAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 8 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 8 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 8 days ago
    Auto-check: notes

Questions about Bib Coverage

What does Bib Coverage do?

Compare a project .bib against a Paperpile project/topic folder to find uncited papers or unfiled entries. Bib Coverage is an agent skill from flonat/flonat-research.bib against a Paperpile project/topic folder to find uncited papers or unfiled entries.

When should I use Bib Coverage?

Bib Coverage fits situations like: the user asks to compare a project .bib against a Paperpile project/topic folder to find uncited papers; unfiled entries.

How do I install Bib Coverage in Claude Code?

Run `npx skills add flonat/flonat-research --skill bib-coverage -a claude-code`. Or copy the skill folder (skills/bib-coverage in flonat/flonat-research) into .claude/skills/bib-coverage in your project. Claude Code loads it when a task matches its description.

How do I install Bib Coverage in Codex?

Run `npx skills add flonat/flonat-research --skill bib-coverage -a codex`. Or copy the skill folder (skills/bib-coverage in flonat/flonat-research) into .agents/skills/bib-coverage in your project. Codex loads it when a task matches its description.

Can I use Bib Coverage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill bib-coverage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bib-coverage, .gemini/skills/bib-coverage, .github/skills/bib-coverage and .opencode/skills/bib-coverage in your project.

What does Bib Coverage need to run?

SKILL.md names no scripts, command-line tools or credentials: Bib Coverage is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep, Bash(paperpile*).

Does Bib Coverage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bib Coverage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bib Coverage use?

Bib Coverage is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bib Coverage use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bib Coverage?

Skills that share tags, products or a category with Bib Coverage: Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Networkx (zLanqing/codex-claude-academic-skills, 4.6k stars), Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars) and Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bib Coverage?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.