@pikaa-ai/pikaa 0.3.1 → 0.3.4

package/skills/citation-management/references/core_workflow.md

@@ -1,569 +0,0 @@
-# Core Workflow
-
-The five phases in full: paper discovery, metadata extraction, the mandatory
-web-search enrichment pass, BibTeX formatting, validation, and integration with the
-writing workflow. Every command variant and option lives here.
-
-## Core Workflow
-
-Citation management follows a systematic process:
-
-### Phase 1: Paper Discovery and Search
-
-**Goal**: Find relevant papers using academic search engines.
-
-#### Google Scholar Search
-
-Google Scholar provides the most comprehensive coverage across disciplines.
-
-**Basic Search**:
-```bash
-# Search for papers on a topic
-python scripts/search_google_scholar.py "CRISPR gene editing" \
-  --limit 50 \
-  --output results.json
-
-# Search with year filter
-python scripts/search_google_scholar.py "machine learning protein folding" \
-  --year-start 2020 \
-  --year-end 2024 \
-  --limit 100 \
-  --output ml_proteins.json
-```
-
-**Advanced Search Strategies** (see `references/google_scholar_search.md`):
-- Use quotation marks for exact phrases: `"deep learning"`
-- Search by author: `author:LeCun`
-- Search in title: `intitle:"neural networks"`
-- Exclude terms: `machine learning -survey`
-- Find highly cited papers using sort options
-- Filter by date ranges to get recent work
-
-**Best Practices**:
-- Use specific, targeted search terms
-- Include key technical terms and acronyms
-- Filter by recent years for fast-moving fields
-- Check "Cited by" to find seminal papers
-- Export top results for further analysis
-
-#### PubMed Search
-
-PubMed specializes in biomedical and life sciences literature (35+ million citations).
-
-**Basic Search**:
-```bash
-# Search PubMed
-python scripts/search_pubmed.py "Alzheimer's disease treatment" \
-  --limit 100 \
-  --output alzheimers.json
-
-# Search with MeSH terms and filters
-python scripts/search_pubmed.py \
-  --query '"Alzheimer Disease"[MeSH] AND "Drug Therapy"[MeSH]' \
-  --date-start 2020 \
-  --date-end 2024 \
-  --publication-types "Clinical Trial,Review" \
-  --output alzheimers_trials.json
-```
-
-**Advanced PubMed Queries** (see `references/pubmed_search.md`):
-- Use MeSH terms: `"Diabetes Mellitus"[MeSH]`
-- Field tags: `"cancer"[Title]`, `"Smith J"[Author]`
-- Boolean operators: `AND`, `OR`, `NOT`
-- Date filters: `2020:2024[Publication Date]`
-- Publication types: `"Review"[Publication Type]`
-- Combine with E-utilities API for automation
-
-**Best Practices**:
-- Use MeSH Browser to find correct controlled vocabulary
-- Construct complex queries in PubMed Advanced Search Builder first
-- Include multiple synonyms with OR
-- Retrieve PMIDs for easy metadata extraction
-- Export to JSON or directly to BibTeX
-
-### Phase 2: Metadata Extraction
-
-**Goal**: Convert paper identifiers (DOI, PMID, arXiv ID) to complete, accurate metadata.
-
-#### Quick DOI to BibTeX Conversion
-
-For single DOIs, use the quick conversion tool:
-
-```bash
-# Convert single DOI
-python scripts/doi_to_bibtex.py 10.1038/s41586-021-03819-2
-
-# Convert multiple DOIs from a file
-python scripts/doi_to_bibtex.py --input dois.txt --output references.bib
-
-# Different output formats
-python scripts/doi_to_bibtex.py 10.1038/nature12345 --format json
-```
-
-#### Comprehensive Metadata Extraction
-
-For DOIs, PMIDs, arXiv IDs, or URLs:
-
-```bash
-# Extract from DOI
-python scripts/extract_metadata.py --doi 10.1038/s41586-021-03819-2
-
-# Extract from PMID
-python scripts/extract_metadata.py --pmid 34265844
-
-# Extract from arXiv ID
-python scripts/extract_metadata.py --arxiv 2103.14030
-
-# Extract from URL
-python scripts/extract_metadata.py --url "https://www.nature.com/articles/s41586-021-03819-2"
-
-# Batch extraction from file (mixed identifiers)
-python scripts/extract_metadata.py --input identifiers.txt --output citations.bib
-```
-
-**Metadata Sources** (see `references/metadata_extraction.md`):
-
-1. **CrossRef API**: Primary source for DOIs
-   - Comprehensive metadata for journal articles
-   - Publisher-provided information
-   - Includes authors, title, journal, volume, pages, dates
-   - Free, no API key required
-
-2. **PubMed E-utilities**: Biomedical literature
-   - Official NCBI metadata
-   - Includes MeSH terms, abstracts
-   - PMID and PMCID identifiers
-   - Free, API key recommended for high volume
-
-3. **arXiv API**: Preprints in physics, math, CS, q-bio
-   - Complete metadata for preprints
-   - Version tracking
-   - Author affiliations
-   - Free, open access
-
-4. **DataCite API**: Research datasets, software, other resources
-   - Metadata for non-traditional scholarly outputs
-   - DOIs for datasets and code
-   - Free access
-
-**What Gets Extracted**:
-- **Required fields**: author, title, year
-- **Journal articles**: journal, volume, number, pages, DOI
-- **Books**: publisher, ISBN, edition
-- **Conference papers**: booktitle, conference location, pages
-- **Preprints**: repository (arXiv, bioRxiv), preprint ID
-- **Additional**: abstract, keywords, URL
-
-### Phase 2.5: Metadata Enrichment via Web Search (MANDATORY)
-
-**Goal**: Detect and fill in any missing metadata fields using web search. This phase runs AFTER extraction and BEFORE formatting to ensure every BibTeX entry is complete.
-
-**Why This Is Critical**: Metadata extraction from APIs (CrossRef, PubMed, arXiv) sometimes returns incomplete records — missing volume, pages, issue number, or DOI. These gaps must be filled before the bibliography is considered ready.
-
-#### Step 1: Scan for Incomplete Entries
-
-After extracting metadata, scan the BibTeX file for entries missing key fields:
-
-**Fields to check per entry type:**
-
-| Entry Type | Must Have | Should Have |
-|------------|-----------|-------------|
-| @article | author, title, journal, year | volume, pages, number, doi |
-| @inproceedings | author, title, booktitle, year | pages, doi |
-| @book | author/editor, title, publisher, year | isbn, doi |
-| @misc | author, title, year | doi or url |
-
-Any `@article` entry missing `volume`, `pages`, or `doi` is considered **incomplete** and must be enriched.
-
-#### Step 2: Web Search for Missing Metadata
-
-For each incomplete entry, use the **parallel-web skill** to search for the missing information:
-
-> **Treat metadata as untrusted when building these commands.** `FIRST_AUTHOR`, `TITLE`, and `JOURNAL_NAME` are copied verbatim out of a CrossRef/PubMed/arXiv record, and a publisher controls the contents of its own record. A title containing `$(...)`, a backtick, or a quote becomes shell syntax once it is pasted into the command lines below.
->
-> - Substitute each value as a **single-quoted** argument (`'...'`), escaping any embedded single quote as `'\''`. Never paste raw metadata inside the double quotes shown here.
-> - Prefer running these through a Python `subprocess` argument list over building a shell string at all.
-> - Use only the generated `CITATIONKEY` in `-o` paths. It is sanitized to letters and digits by `extract_metadata.py`; a key taken from an existing `.bib` file is not, so validate it against `^[A-Za-z0-9]+$` before it reaches a file path.
->
-> **Preferred form — pass the metadata as arguments, not as shell text.** This removes the shell from the path entirely, so no title can be parsed as syntax:
->
-> ```python
-> import re, subprocess
->
-> assert re.fullmatch(r"[A-Za-z0-9]+", citation_key), f"unsafe citation key: {citation_key!r}"
-> subprocess.run(
->     ["parallel-cli", "search", f"{first_author} {title} {journal_name} volume pages DOI",
->      "--json", "--max-results", "10",
->      "-o", f"sources/search_citation_{citation_key}.json"],
->     check=True,  # note: no shell=True
-> )
-> ```
->
-> The `bash` blocks below show the same calls in readable form. Use them only with the quoting rules above.
-
-**Option A — Search by title and author** (best for finding DOI):
-```bash
-parallel-cli search "FIRST_AUTHOR TITLE JOURNAL_NAME volume pages DOI" \
-  --json --max-results 10 \
-  -o sources/search_citation_CITATIONKEY.json
-```
-
-**Option B — Extract from DOI page** (best when DOI is known but volume/pages missing):
-```bash
-parallel-cli extract "https://doi.org/10.XXXX/YYYY" --json \
-  --objective "extract complete citation metadata: volume, issue, pages, publication date" \
-  -o sources/extract_doi_CITATIONKEY.json
-```
-
-**Option C — Search CrossRef API directly** (programmatic, fast):
-```bash
-parallel-cli search "crossref DOI metadata FIRST_AUTHOR TITLE" \
-  --json --max-results 10 \
-  -o sources/search_crossref_CITATIONKEY.json
-```
-
-**Option D — Search Google Scholar** (fallback for hard-to-find papers):
-```bash
-parallel-cli search "google scholar FIRST_AUTHOR TITLE YEAR complete citation" \
-  --json --max-results 10 \
-  -o sources/search_scholar_CITATIONKEY.json
-```
-
-#### Step 3: Update BibTeX Entries
-
-After finding the missing metadata:
-
-1. Open `references.bib`
-2. Add the missing fields to the incomplete entry
-3. Verify the found metadata is consistent with existing fields (same author, title, year)
-4. Log each fix:
-   ```
-   [HH:MM:SS] METADATA ENRICHED: [CitationKey] - added volume={X}, pages={Y--Z}, doi={10.XXX/YYY} ✅
-   ```
-
-#### Step 4: Handle Unfindable Metadata
-
-If metadata genuinely cannot be found after web search (very old paper, obscure conference, etc.):
-
-1. Add a `note` field to the BibTeX entry explaining the gap:
-   ```bibtex
-   note = {Volume and pages not available — published online only}
-   ```
-2. Log the exception:
-   ```
-   [HH:MM:SS] METADATA INCOMPLETE: [CitationKey] - pages unavailable (online-only publication) ⚠️
-   ```
-3. These exceptions should be rare — most modern papers have complete metadata findable via web search.
-
-#### Quick Reference: Common Missing Fields and Where to Find Them
-
-| Missing Field | Best Search Strategy |
-|---------------|---------------------|
-| DOI | Search "AUTHOR TITLE DOI" via parallel-cli search |
-| Volume | Extract from DOI page or search "JOURNAL YEAR TITLE volume" |
-| Pages | Extract from DOI page or search publisher website |
-| Issue/Number | Extract from DOI page or CrossRef |
-| Publisher | Search "JOURNAL publisher" or check journal website |
-
----
-
-### Phase 3: BibTeX Formatting
-
-**Goal**: Generate clean, properly formatted BibTeX entries.
-
-#### Understanding BibTeX Entry Types
-
-See `references/bibtex_formatting.md` for complete guide.
-
-**Common Entry Types**:
-- `@article`: Journal articles (most common)
-- `@book`: Books
-- `@inproceedings`: Conference papers
-- `@incollection`: Book chapters
-- `@phdthesis`: Dissertations
-- `@misc`: Preprints, software, datasets
-
-**Required Fields by Type**:
-
-```bibtex
-@article{citationkey,
-  author  = {Last1, First1 and Last2, First2},
-  title   = {Article Title},
-  journal = {Journal Name},
-  year    = {2024},
-  volume  = {10},
-  number  = {3},
-  pages   = {123--145},
-  doi     = {10.1234/example}
-}
-
-@inproceedings{citationkey,
-  author    = {Last, First},
-  title     = {Paper Title},
-  booktitle = {Conference Name},
-  year      = {2024},
-  pages     = {1--10}
-}
-
-@book{citationkey,
-  author    = {Last, First},
-  title     = {Book Title},
-  publisher = {Publisher Name},
-  year      = {2024}
-}
-```
-
-#### Formatting and Cleaning
-
-Use the formatter to standardize BibTeX files:
-
-```bash
-# Format and clean BibTeX file
-python scripts/format_bibtex.py references.bib \
-  --output formatted_references.bib
-
-# Sort entries by citation key
-python scripts/format_bibtex.py references.bib \
-  --sort key \
-  --output sorted_references.bib
-
-# Sort by year (newest first)
-python scripts/format_bibtex.py references.bib \
-  --sort year \
-  --descending \
-  --output sorted_references.bib
-
-# Remove duplicates
-python scripts/format_bibtex.py references.bib \
-  --deduplicate \
-  --output clean_references.bib
-
-# Merge sources: one key scheme, then drop duplicates
-python scripts/format_bibtex.py references.bib \
-  --rekey \
-  --deduplicate \
-  --output merged_references.bib
-```
-
-**Formatting Operations**:
-- Standardize field order
-- Consistent indentation and spacing
-- Proper capitalization in titles (protected with {})
-- Standardized author name format
-- Consistent citation key format
-- Remove unnecessary fields
-- Fix common errors (missing commas, braces)
-
-### Phase 4: Citation Validation
-
-**Goal**: Verify all citations are accurate and complete.
-
-#### Comprehensive Validation
-
-```bash
-# Validate BibTeX file
-python scripts/validate_citations.py references.bib
-
-# Validate against a venue standard (e.g., Nature, NeurIPS, Literature Review)
-python scripts/validate_citations.py references.bib --venue nature
-python scripts/validate_citations.py references.bib --venue neurips
-python scripts/validate_citations.py references.bib --venue review
-
-# Validate with custom minimum citation count
-python scripts/validate_citations.py references.bib --min-count 40
-
-# Check references against a written manuscript file (detect missing or unused citations)
-python scripts/validate_citations.py references.bib --manuscript paper.md
-
-# Generate detailed validation report
-python scripts/validate_citations.py references.bib \
-  --venue nature \
-  --manuscript paper.md \
-  --report validation_report.json \
-  --verbose
-```
-
-**Validation Checks** (see `references/citation_validation.md`):
-
-1. **DOI Verification**:
-   - DOI resolves correctly via doi.org
-   - Metadata matches between BibTeX and CrossRef
-   - No broken or invalid DOIs
-
-2. **Required Fields**:
-   - All required fields present for entry type
-   - No empty or missing critical information
-   - Author names properly formatted
-
-3. **Data Consistency**:
-   - Year is valid (4 digits, reasonable range)
-   - Volume/number are numeric
-   - Pages formatted correctly (e.g., 123--145)
-   - URLs are accessible
-
-4. **Duplicate Detection**:
-   - Same DOI used multiple times
-   - Similar titles (possible duplicates)
-   - Same author/year/title combinations
-
-5. **Format Compliance**:
-   - Valid BibTeX syntax
-   - Proper bracing and quoting
-   - Citation keys are unique
-   - Special characters handled correctly
-
-**Validation Output**:
-```json
-{
-  "total_entries": 150,
-  "valid_entries": 145,
-  "errors": [
-    {
-      "citation_key": "Smith2023",
-      "error_type": "missing_field",
-      "field": "journal",
-      "severity": "high"
-    },
-    {
-      "citation_key": "Jones2022",
-      "error_type": "invalid_doi",
-      "doi": "10.1234/broken",
-      "severity": "high"
-    }
-  ],
-  "warnings": [
-    {
-      "citation_key": "Brown2021",
-      "warning_type": "possible_duplicate",
-      "duplicate_of": "Brown2021a",
-      "severity": "medium"
-    }
-  ]
-}
-```
-
-#### Citation Count Standards by Venue
-
-**Citations must always be high in number based on standards for journal and conference publications in the venue of choice or recommendation.** Never settle for a sparse reference list; establish an authoritative, rich context with dense, verified citations.
-
-| Venue Type | Target Citation Count |
-|------------|----------------------|
-| High-impact multidisciplinary journals (Nature, Science, Cell) | **35-50+** |
-| ML / CS conferences (NeurIPS, ICML, ICLR, CVPR, ACL) | **30-45+** |
-| Comprehensive literature reviews / market research reports | **40-65+** |
-| Medical journals (NEJM, Lancet, JAMA) | **30-45+** |
-
-Always adjust the citation target upward depending on standard density and practices of the target venue. Avoid 'lazy' citation over-repetition — do not repeatedly cite the same 1 or 2 papers to support multiple unrelated claims; draw from a diverse, high-quality set of reputable references.
-
-Enforce these standards programmatically with `validate_citations.py --venue <venue>` or `--min-count <N>`.
-
-#### Mandatory Post-Writing Reference Checks (Non-Negotiable)
-
-Once the entire scientific report or paper has been drafted and written, perform a comprehensive post-writing verification of all citations before compiling the final deliverables:
-
-1. **Verify No Missing or Unresolved Citations**: Check the draft or compiled document to ensure that every in-text citation correctly resolves to a reference in `references.bib`. There must be ZERO broken citation keys, missing identifiers, or unresolved references (e.g., `[?]` or `[citation needed]`).
-2. **Verify No Unused (Dangling) Bibliography Entries**: Check that every entry in `references.bib` is actually cited in the body of the report. Remove any unused entries to keep the bibliography perfectly clean.
-3. **Verify Citation Quantity Against Target Standards**: Ensure the final citation count meets or exceeds the high standard of the chosen or recommended venue (see table above). If the count is below standard, perform additional literature search first, find high-quality papers, and integrate them into appropriate sections.
-4. **Verify Metadata Completeness**: Confirm that all cited entries contain complete, fully-verified fields (all author names, complete journal/conference names, exact year, volume, issue, page range, and valid DOI).
-
-Run all of these checks in one command:
-
-```bash
-python scripts/validate_citations.py references.bib \
-  --venue <venue> \
-  --manuscript paper.md \
-  --report post_writing_check.json
-```
-
-### Phase 5: Integration with Writing Workflow
-
-#### Building References for Manuscripts
-
-Complete workflow for creating a bibliography:
-
-```bash
-# 1. Search for papers on your topic
-python scripts/search_pubmed.py \
-  '"CRISPR-Cas Systems"[MeSH] AND "Gene Editing"[MeSH]' \
-  --date-start 2020 \
-  --limit 200 \
-  --output crispr_papers.json
-
-# 2. Extract DOIs from search results and convert to BibTeX
-python scripts/extract_metadata.py \
-  --input crispr_papers.json \
-  --output crispr_refs.bib
-
-# 3. Add specific papers by DOI
-python scripts/doi_to_bibtex.py 10.1038/nature12345 >> crispr_refs.bib
-python scripts/doi_to_bibtex.py 10.1126/science.abcd1234 >> crispr_refs.bib
-
-# 4. Format and clean the BibTeX file
-python scripts/format_bibtex.py crispr_refs.bib \
-  --deduplicate \
-  --sort year \
-  --descending \
-  --output references.bib
-
-# 5. Validate all citations
-python scripts/validate_citations.py references.bib \
-  --report validation.json
-
-# 6. Review validation report and fix any remaining issues
-cat validation.json
-
-# 7. Use in your LaTeX document
-# \bibliography{final_references}
-```
-
-#### Integration with Literature Review Skill
-
-This skill complements the `literature-review` skill:
-
-**Literature Review Skill** → Systematic search and synthesis
-**Citation Management Skill** → Technical citation handling
-
-**Combined Workflow**:
-1. Use `literature-review` for comprehensive multi-database search
-2. Use `citation-management` to extract and validate all citations
-3. Use `literature-review` to synthesize findings thematically
-4. Use `citation-management` to verify final bibliography accuracy
-
-```bash
-# After completing literature review
-# Verify all citations in the review document
-python scripts/validate_citations.py my_review_references.bib --report review_validation.json
-
-# Normalise formatting (venue style is chosen by the .bst at build time)
-python scripts/format_bibtex.py my_review_references.bib \
-  --output formatted_refs.bib
-```
-
-#### Integration with Zotero (pyzotero Skill)
-
-When the user already keeps references in Zotero, treat the Zotero library as the source of truth for the bibliography and use this skill for validation and formatting. The `pyzotero` skill covers the library side — reading items and collections, creating and updating references, uploading attachments, and exporting citations via the Zotero Web API v3.
-
-**Zotero Library (`pyzotero`)** → Library of record: storage, collections, tags, attachments
-**Citation Management Skill** → Metadata accuracy: validation, enrichment, style formatting
-
-**Combined Workflow**:
-1. Use `pyzotero` to pull the working set from the Zotero library, filtered by collection or tag
-2. Export it as BibTeX with `zot.add_parameters(format='bibtex')` (see `pyzotero` → `references/exports.md`)
-3. Use `citation-management` to validate the exported entries and repair incomplete metadata
-4. Use `citation-management` to format for the target venue
-5. Optionally use `pyzotero` to write corrected fields back so the library benefits from the fixes
-
-```bash
-# 1-2. Export the desired collection from Zotero as BibTeX (pyzotero skill)
-#      zot.add_parameters(format='bibtex'); bibtex = zot.collection_items(collection_id)
-#      → write to zotero_export.bib
-
-# 3. Validate the exported bibliography
-python scripts/validate_citations.py zotero_export.bib --report zotero_validation.json
-
-# 4. Normalise the export (venue style comes from the .bst at build time)
-python scripts/format_bibtex.py zotero_export.bib \
-  --output formatted_refs.bib
-```
-
-Zotero exports are only as good as what was captured — browser-connector entries in particular often carry missing DOIs, truncated author lists, or preprint metadata for papers since published. Run the validation step before submission rather than trusting the export, and prefer writing corrections back to Zotero so the same errors do not resurface in the next manuscript.

package/skills/citation-management/references/example_workflows.md

@@ -1,126 +0,0 @@
-# Example Workflows
-
-Four end-to-end worked examples: building a bibliography for a paper, converting a
-list of DOIs, cleaning an existing BibTeX file, and finding and citing seminal papers.
-
-## Example Workflows
-
-### Example 1: Building a Bibliography for a Paper
-
-```bash
-# Step 1: Find key papers on your topic
-python scripts/search_google_scholar.py "transformer neural networks" \
-  --year-start 2017 \
-  --limit 50 \
-  --output transformers_gs.json
-
-python scripts/search_pubmed.py "deep learning medical imaging" \
-  --date-start 2020 \
-  --limit 50 \
-  --output medical_dl_pm.json
-
-# Step 2: Extract metadata from search results
-python scripts/extract_metadata.py \
-  --input transformers_gs.json \
-  --output transformers.bib
-
-python scripts/extract_metadata.py \
-  --input medical_dl_pm.json \
-  --output medical.bib
-
-# Step 3: Add specific papers you already know
-python scripts/doi_to_bibtex.py 10.1038/s41586-021-03819-2 >> specific.bib
-python scripts/doi_to_bibtex.py 10.1126/science.aam9317 >> specific.bib
-
-# Step 4: Combine all BibTeX files
-cat transformers.bib medical.bib specific.bib > combined.bib
-
-# Step 5: Format and deduplicate
-python scripts/format_bibtex.py combined.bib \
-  --deduplicate \
-  --sort year \
-  --descending \
-  --output formatted.bib
-
-# Step 6: Validate
-python scripts/validate_citations.py formatted.bib \
-  --report validation.json
-
-# Step 7: Review any issues
-cat validation.json | grep -A 3 '"errors"'
-
-# Step 8: Use in LaTeX
-# \bibliography{final_references}
-```
-
-### Example 2: Converting a List of DOIs
-
-```bash
-# You have a text file with DOIs (one per line)
-# dois.txt contains:
-# 10.1038/s41586-021-03819-2
-# 10.1126/science.aam9317
-# 10.1016/j.cell.2023.01.001
-
-# Convert all to BibTeX
-python scripts/doi_to_bibtex.py --input dois.txt --output references.bib
-
-# Validate the result
-python scripts/validate_citations.py references.bib --verbose
-```
-
-### Example 3: Cleaning an Existing BibTeX File
-
-```bash
-# You have a messy BibTeX file from various sources
-# Clean it up systematically
-
-# Step 1: Format and standardize
-python scripts/format_bibtex.py messy_references.bib \
-  --output step1_formatted.bib
-
-# Step 2: Remove duplicates
-python scripts/format_bibtex.py step1_formatted.bib \
-  --deduplicate \
-  --output step2_deduplicated.bib
-
-# Step 3: Check what is still wrong before sorting
-python scripts/validate_citations.py step2_deduplicated.bib \
-  --report step3_validation.json
-
-# Step 4: Sort by year
-python scripts/format_bibtex.py step2_deduplicated.bib \
-  --sort year \
-  --descending \
-  --output clean_references.bib
-
-# Step 5: Final validation report
-python scripts/validate_citations.py clean_references.bib \
-  --report final_validation.json \
-  --verbose
-
-# Review report
-cat final_validation.json
-```
-
-### Example 4: Finding and Citing Seminal Papers
-
-```bash
-# Find highly cited papers on a topic
-python scripts/search_google_scholar.py "AlphaFold protein structure" \
-  --year-start 2020 \
-  --year-end 2024 \
-  --sort-by citations \
-  --limit 20 \
-  --output alphafold_seminal.json
-
-# Extract the top 10 by citation count
-# (script will have included citation counts in JSON)
-
-# Convert to BibTeX
-python scripts/extract_metadata.py \
-  --input alphafold_seminal.json \
-  --output alphafold_refs.bib
-
-# The BibTeX file now contains the most influential papers
-```