Citation and reference validator

Skill lensetek/Research-Agent-Skills-Collection/skills/citation_and_reference_validator

Research Agent Skills Collection

Install

npx -y skills add lensetek/Research-Agent-Skills-Collection --skill citation_and_reference_validator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Memvalidasi kebenaran metadata referensi (DOI, tautan, judul, penulis, tahun) dan keselarasan kontekstual antara kalimat klaim di naskah dengan konten paper yang dirujuk.

SKILL.md

4.7 KB, as published. Nobody here has run it

Citation & Reference Validator

Overview

Skill ini dirancang untuk melakukan audit kualitas terhadap kutipan (citations) dan daftar pustaka (references) dalam sebuah naskah ilmiah. Agen memastikan bahwa semua rujukan memiliki metadata yang valid (bebas dari referensi palsu hasil halusinasi AI) dan bahwa teks kalimat rujukan dalam naskah benar-benar didukung secara faktual oleh paper yang disitasi (contextual alignment).

Dependencies

literature-search-openalex
pubmed-database

Quick Start

Contoh penggunaan: "Gunakan skill citation-and-reference-validator untuk mengecek apakah kalimat klaim 'Metode X memiliki akurasi 98% (Smith et al., 2022)' benar-benar didukung oleh isi paper Smith et al. dengan DOI 10.1000/xyz."

Workflow

1. Validasi Metadata Referensi (Programmatic Metadata Integrity Audit)

Eksekusi Guardrail Programatik (WAJIB): Sebelum melakukan penilaian manual, agen WAJIB mengeksekusi skrip verifikasi otomatis untuk memvalidasi daftar pustaka terhadap API Crossref dan OpenAlex. (Catatan: Tentukan path absolut dari validate_references.py berdasarkan lokasi direktori SKILL.md ini berada, baik instalasi lokal maupun global):
```
python "<PATH_KE_SKILL>/scripts/validate_references.py" --input references.json --output report.json
```
atau jalankan secara langsung untuk single DOI/Title:
```
python "<PATH_KE_SKILL>/scripts/validate_references.py" --doi <DOI> --title "<TITLE>"
```
Evaluasi luaran report.json:
- VALID: Metadata terverifikasi resmi oleh database publik (Crossref/OpenAlex).
- METADATA_MISMATCH: Paper ditemukan, namun atribut tahun/penulis/judul yang diberikan berbeda signifikan dari database asli.
- HALLUCINATED: DOI atau judul tidak ditemukan di basis data publik manapun. Wajib langsung ditolak / dibuang dari daftar rujukan.
Tandai referensi yang berstatus HALLUCINATED atau METADATA_MISMATCH secara eksplisit pada laporan audit.

2. Validasi Keselarasan Konteks Kutipan (Evidence-Based Citation Grounding)

Eksekusi Snippet Fetcher Programatik (WAJIB): Untuk mengecek apakah klaim naskah didukung secara faktual oleh isi paper asli, agen WAJIB mengeksekusi skrip penarik bukti verbatim:
```
python "<PATH_KE_SKILL>/scripts/fetch_evidence_snippet.py" --claim "<KALIMAT_KLAIM>" --doi "<DOI>"
```
Evaluasi luaran evidence_snippets dari skrip Python:
- FULLY_SUPPORTED: Terdapat kutipan verbatim di paper asli yang selaras 100% dengan klaim naskah.
- PARTIALLY_SUPPORTED: Terdapat kutipan relevan tetapi membutuhkan batasan/konteks tambahan di naskah (misal: "hanya berlaku pada dataset X").
- CONTRADICTORY: Kutipan asli paper justru menyatakan hal sebaliknya dari klaim naskah.
- UNSUPPORTED / MISATTRIBUTED: Klaim tidak dibahas atau paper membahas topik yang berbeda sama sekali.

3. Pengecekan Gaya Sitasi & Konsistensi (Format Check)

Pastikan penulisan sitasi konsisten mengikuti pedoman penulisan tertentu (e.g., APA, IEEE, Harvard, MLA) baik di dalam teks maupun di daftar pustaka.
Pastikan semua dokumen yang disitasi di dalam teks tercantum di daftar pustaka, dan sebaliknya.

4. Format Laporan Validasi Rujukan

Sajikan laporan audit rujukan dalam format tabel bukti wajib berikut:

Teks Kalimat / Klaim Naskah	Paper Rujukan (Sitasi & DOI)	Kutipan Verbatim Asli dari Paper (Evidence Snippet)	Status Dukungan Kontekstual	Catatan Perbaikan

Common Mistakes & Aturan Kritis (Anti-Halusinasi Referensi)

Referensi Halusinasi (Fake References): Menyertakan rujukan buatan AI yang terlihat meyakinkan (memiliki nama penulis terkenal dan judul yang masuk akal) namun sebenarnya tidak pernah dipublikasikan atau DOI-nya palsu.
Kutipan Berantai yang Menyesatkan (Lazy Citation): Mengutip paper B yang mengutip paper A untuk suatu teori, padahal isi asli paper A berbeda dengan interpretasi paper B. Agen wajib menelusuri sumber primer jika kemungkinan akses PDF/Teks penuh terbuka tersedia.
Overgeneralization Citation: Mengutip paper eksperimen spesifik seolah-olah itu membuktikan teori universal tanpa menyebutkan batasan uji eksperimen dari paper tersebut.
Salah Format Penulisan: Tidak konsisten dalam menyusun daftar referensi (menggabungkan format APA dan IEEE secara acak).
Hambatan API Key: Menghentikan proses audit atau memunculkan pesan error ketika API Key Semantic Scholar tidak terisi. Lakukan validasi silang menggunakan API publik gratis (OpenAlex / Crossref) yang tidak membatasi akses tanpa token.