database-check

Validate literature database structure and cross-references between index.yaml and references.bib.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/ryan-ressmeyer/llm-skills --skill database-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: database-check
Source: https://github.com/ryan-ressmeyer/llm-skills/tree/main/database-check
Command: npx skills add https://github.com/ryan-ressmeyer/llm-skills --skill database-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures the integrity and consistency of your literature database, preventing issues like missing files, broken references, and metadata discrepancies.

Core Features & Use Cases

  • Integrity Checks: Validates folder structure, naming conventions, and file presence.
  • Metadata Validation: Cross-references index.yaml, references.bib, and actual files for consistency.
  • Use Case: After adding a batch of new papers, run this skill to automatically verify that all PDFs and summaries are present, all entries in index.yaml have corresponding folders, and that BibTeX entries are correctly linked.

Quick Start

Run a full integrity check on the database located in the 'references/' directory.

Frequently Asked Questions about database-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my BibTeX database for missing files and metadata inconsistencies?

You can validate your literature database by cross-referencing index.yaml and references.bib against actual files, checking folder naming conventions and file presence to identify missing PDFs and metadata inconsistencies.

What is literature database integrity validation and how does it work?

Literature database integrity validation is the process of verifying structural consistency by cross-referencing index.yaml and references.bib with actual files, reporting issues with severity levels to highlight missing entries and broken cross-references.

Do I need Python and PyYAML to run a literature database integrity check?

Yes, you need Python 3.10+ and the PyYAML dependency installed to run a literature database integrity check, as PyYAML is required for parsing YAML files and performing structural validation checks on the database contents.

How do I validate index.yaml cross-references against references.bib entries?

To validate index.yaml cross-references against references.bib entries, run a full integrity check on the references directory to verify that all metadata entries have corresponding folders and BibTeX entries are correctly linked.

What are common literature database maintenance issues after adding new papers?

Common literature database maintenance issues after adding new papers include missing PDFs and summaries, index.yaml entries lacking corresponding folders, and incorrectly linked BibTeX entries, which are reported with severity levels.

Can I use this database validation script for ongoing literature review maintenance?

Yes, you can use this validation script for ongoing literature review maintenance by running it after adding batches of new papers to automatically verify file presence, confirm metadata consistency, and report structural sync issues.