Skills › Scientific Agent Skills › citation-management › best_practices.md
best_practices.md
91 lines · skills/citation-management/references/best_practices.md at 5f2bc03
Best Practices
Search strategy, metadata extraction, BibTeX quality, and validation practices.
Raw lines 1 to 4Best Practices
Raw lines 5 to 67### Search Strategy
91. **Start broad, then narrow**:
10 - Begin with general terms to understand the field
11 - Refine with specific keywords and filters
12 - Use synonyms and related terms
142. **Use multiple sources**:
15 - Google Scholar for comprehensive coverage
16 - PubMed for biomedical focus
17 - arXiv for preprints
18 - Combine results for completeness
203. **Leverage citations**:
21 - Check "Cited by" for seminal papers
22 - Review references from key papers
23 - Use citation networks to discover related work
254. **Document your searches**:
26 - Save search queries and dates
27 - Record number of results
28 - Note any filters or restrictions applied
Search Strategy
- Start broad, then narrow:
- Begin with general terms to understand the field
- Refine with specific keywords and filters
- Use synonyms and related terms
- Use multiple sources:
- Google Scholar for comprehensive coverage
- PubMed for biomedical focus
- arXiv for preprints
- Combine results for completeness
- Leverage citations:
- Check "Cited by" for seminal papers
- Review references from key papers
- Use citation networks to discover related work
- Document your searches:
- Save search queries and dates
- Record number of results
- Note any filters or restrictions applied
30### Metadata Extraction
321. **Always use DOIs when available**:
33 - Most reliable identifier
34 - Permanent link to the publication
35 - Best metadata source via CrossRef
372. **Verify extracted metadata**:
38 - Check author names are correct
39 - Verify journal/conference names
40 - Confirm publication year
41 - Validate page numbers and volume
433. **Handle edge cases**:
44 - Preprints: Include repository and ID
45 - Preprints later published: Use published version
46 - Conference papers: Include conference name and location
47 - Book chapters: Include book title and editors
494. **Maintain consistency**:
50 - Use consistent author name format
51 - Standardize journal abbreviations
52 - Use a bare identifier in the BibTeX `doi` field; use the resolver URL in prose
Metadata Extraction
- Always use DOIs when available:
- Most reliable identifier
- Permanent link to the publication
- Best metadata source via CrossRef
- Verify extracted metadata:
- Check author names are correct
- Verify journal/conference names
- Confirm publication year
- Validate page numbers and volume
- Handle edge cases:
- Preprints: Include repository and ID
- Preprints later published: Use published version
- Conference papers: Include conference name and location
- Book chapters: Include book title and editors
- Maintain consistency:
- Use consistent author name format
- Standardize journal abbreviations
- Use a bare identifier in the BibTeX
doifield; use the resolver URL in prose
54### BibTeX Quality
561. **Follow conventions**:
57 - Use meaningful citation keys (FirstAuthor2024keyword)
58 - Protect capitalization in titles with {}
59 - Use -- for page ranges (not single dash)
60 - Include the DOI field when a DOI has been assigned
622. **Keep it clean**:
63 - Remove unnecessary fields
64 - No redundant information
65 - Consistent formatting
66 - Validate syntax regularly
683. **Organize systematically**:
69 - Sort by year or topic
70 - Group related papers
71 - Use separate files for different projects
72 - Merge carefully to avoid duplicates
BibTeX Quality
- Follow conventions:
- Use meaningful citation keys (FirstAuthor2024keyword)
- Protect capitalization in titles with {}
- Use -- for page ranges (not single dash)
- Include the DOI field when a DOI has been assigned
- Keep it clean:
- Remove unnecessary fields
- No redundant information
- Consistent formatting
- Validate syntax regularly
- Organize systematically:
- Sort by year or topic
- Group related papers
- Use separate files for different projects
- Merge carefully to avoid duplicates
74### Validation
761. **Validate early and often**:
77 - Check citations when adding them
78 - Validate complete bibliography before submission
79 - Re-validate after any manual edits
812. **Fix issues promptly**:
82 - Broken DOIs: Find correct identifier
83 - Missing fields: Extract from original source
84 - Duplicates: Choose best version, remove others
85 - Format errors: Use auto-fix when safe
873. **Manual review for critical citations**:
88 - Verify key papers cited correctly
89 - Check author names match publication
90 - Confirm page numbers and volume
91 - Ensure URLs are current
Validation
- Validate early and often:
- Check citations when adding them
- Validate complete bibliography before submission
- Re-validate after any manual edits
- Fix issues promptly:
- Broken DOIs: Find correct identifier
- Missing fields: Extract from original source
- Duplicates: Choose best version, remove others
- Format errors: Use auto-fix when safe
- Manual review for critical citations:
- Verify key papers cited correctly
- Check author names match publication
- Confirm page numbers and volume
- Ensure URLs are current