--- id: inno-reference-audit name: inno-reference-audit version: 0.1.0 description: |- This skill provides reference guidance for citation verification in academic writing. stages: ["publication"] tools: ["read_file", "search_project", "write_file", "run_terminal"] summary: |- This skill provides reference guidance for citation verification in academic writing. Use when the user asks about "citation verification best practices", "how to verify references", "preventing fake citations", or needs guidance on citati... primaryIntent: evaluation intents: ["evaluation", "writing"] capabilities: ["evaluation-benchmarking", "search-retrieval"] domains: ["general"] keywords: ["research", "academic", "citation", "reference", "inno-reference-audit", "paper review", "evaluation-benchmarking", "search-retrieval", "inno", "audit", "this", "provides"] source: builtin status: verified upstream: repo: dr-claw path: skills/inno-reference-audit revision: 8322dc4ef575affaa374aa7922c0a0971c6db7d7 resourceFlags: hasReferences: true hasScripts: true hasTemplates: false hasAssets: false referenceCount: 4 scriptCount: 4 templateCount: 0 assetCount: 0 optionalScripts: true --- # inno-reference-audit ## Canonical Summary This skill provides reference guidance for citation verification in academic writing. Use when the user asks about "citation verification best practices", "how to verify references", "preventing fake citations", or needs guidance on citati... ## Trigger Rules Use this skill when the user request matches its research workflow scope. Prefer the bundled resources instead of recreating templates or reference material. Keep outputs traceable to project files, citations, scripts, or upstream evidence. ## Resource Use Rules - Read from `references/` only when the current task needs the extra detail. - Treat `scripts/` as optional helpers. Run them only when their dependencies are available, keep outputs in the project workspace, and explain a manual fallback if execution is blocked. ## Execution Contract - Resolve every relative path from this skill directory first. - Prefer inspection before mutation when invoking bundled scripts. - If a required runtime, CLI, credential, or API is unavailable, explain the blocker and continue with the best manual fallback instead of silently skipping the step. - Do not write generated artifacts back into the skill directory; save them inside the active project workspace. ## Upstream Instructions # Citation Verification Reference Guide A reference guide for citation verification in academic paper writing, providing verification principles and best practices. **Core Principle**: Proactively verify every citation during the writing process using WebSearch and Google Scholar. ## Core Problems Citation issues in academic papers seriously impact research integrity: 1. **Fake citations** - Citing non-existent papers (common issue with AI-generated citations) 2. **Incorrect information** - Mismatched authors, titles, years, etc. 3. **Inconsistent formatting** - Mixed citation formats 4. **Missing citations** - Referenced but uncited work These issues can lead to: - Paper rejection or retraction - Damage to academic reputation - Reviewers questioning research rigor **Special risk with AI-assisted writing**: AI-generated citations have approximately 40% error rate; every citation must be verified via WebSearch. ## Verification Principles This skill provides verification principles based on WebSearch and Google Scholar: ### 1. Proactive Verification (Verify During Writing) **Core idea**: Verify immediately when adding a citation, rather than checking after writing is complete. - Search for the paper via WebSearch each time a citation is needed - Confirm the paper exists on Google Scholar - Add to bibliography only after verification passes ### 2. Google Scholar Verification **Why Google Scholar**: - Most comprehensive academic literature coverage - Provides citation count (credibility indicator) - Directly provides BibTeX format - Free and no API required **Verification steps**: 1. WebSearch query: `"site:scholar.google.com [paper title] [first author]"` 2. Confirm the paper appears in results 3. Check citation count (abnormally low counts may indicate issues) 4. Click "Cite" to get BibTeX ### 3. Information Matching Verification **Information that must match**: - Title (minor differences allowed, e.g., capitalization) - Authors (at least the first author must match) - Year (±1 year difference allowed, considering preprints) - Publication venue (conference/journal name) ### 4. Claim Verification **Key principle**: When citing a specific claim, you must confirm the claim actually appears in the paper. - Use WebSearch to access the paper PDF - Search for relevant keywords - Confirm the accuracy of the claim - Record the section/page where the claim appears ## Verification Workflow ### Integration into Writing Process ``` Need a citation during writing ↓ WebSearch to find the paper ↓ Google Scholar to verify existence ↓ Confirm paper details ↓ Get BibTeX ↓ (If citing a specific claim) Verify the claim ↓ Add to bibliography ``` **Key point**: Verification is part of the writing process, not a separate post-processing step. ## Usage Guide ### Using with ml-paper-writing The verification principles of this skill are integrated into the Citation Workflow of the `ml-paper-writing` skill. **Auto-trigger**: Citation verification is automatically executed when writing papers with the ml-paper-writing skill. **Manual reference**: Refer to this skill when you need detailed verification principles. ### Verification Step Example **Scenario**: Need to cite the Transformer paper ``` Step 1: WebSearch lookup Query: "Attention is All You Need Vaswani 2017" Result: Found multiple sources for the paper Step 2: Google Scholar verification Query: "site:scholar.google.com Attention is All You Need Vaswani" Result: ✅ Paper exists, 50,000+ citations, NeurIPS 2017 Step 3: Confirm details - Title: "Attention is All You Need" - Authors: Vaswani, Ashish; Shazeer, Noam; Parmar, Niki; ... - Year: 2017 - Venue: NeurIPS (NIPS) Step 4: Get BibTeX - Click "Cite" on Google Scholar - Select BibTeX format - Copy BibTeX entry Step 5: Add to bibliography - Paste into .bib file - Use \cite{vaswani2017attention} in the paper ``` ### Handling Verification Failures **If the paper cannot be found on Google Scholar**: 1. **Check spelling** - Is the title or author name correct? 2. **Try different queries** - Use different keyword combinations 3. **Find alternative sources** - Try arXiv, DOI 4. **Mark as pending** - Use `[CITATION NEEDED]` marker 5. **Notify the user** - Clearly state the citation cannot be verified **If information doesn't match**: 1. **Confirm the source** - Did you find the correct paper? 2. **Check versions** - Preprint vs. published version 3. **Update information** - Use the most accurate version 4. **Record discrepancies** - Note the reason for differences ## Best Practices ### Preventing Fake Citations 1. **Never generate citations from memory** - AI-generated citations have 40% error rate 2. **Use WebSearch to find** - Verify every citation through WebSearch 3. **Confirm on Google Scholar** - Verify paper existence on Google Scholar 4. **Verify promptly** - Verify when adding citations, don't wait until finished ### Handling Verification Failures 1. **Don't guess** - If you can't find the paper, don't fabricate information 2. **Mark clearly** - Use `[CITATION NEEDED]` to mark explicitly 3. **Notify the user** - Clearly state which citations cannot be verified 4. **Provide reasons** - Explain why verification failed (not found, info mismatch, etc.) ### Improving Verification Accuracy 1. **Complete queries** - Include title, author, year 2. **Check citation count** - Citation count on Google Scholar is a credibility indicator 3. **Confirm venue** - Verify conference/journal name is correct 4. **Verify claims** - When citing specific claims, confirm they exist in the paper ### Common Pitfalls ❌ **Wrong approach**: - Generating BibTeX from memory - Skipping Google Scholar verification - Assuming a paper exists - Not marking unverifiable citations ✅ **Correct approach**: - Search every citation with WebSearch - Confirm on Google Scholar - Copy BibTeX from Google Scholar - Clearly mark unverifiable citations ## Summary **Core Principle**: Proactively verify every citation during the writing process using WebSearch and Google Scholar. **Key Steps**: 1. WebSearch to find the paper 2. Google Scholar to verify existence 3. Confirm details 4. Get BibTeX 5. Verify claims (if needed) 6. Add to bibliography **Failure handling**: When verification fails, mark as `[CITATION NEEDED]` and clearly notify the user. **Integration**: The principles of this skill are integrated into the ml-paper-writing skill for automatic verification.