# Citation And Reference Validator

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

- Skill: `lensetek/citation-and-reference-validator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lensetek/citation-and-reference-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lensetek/citation-and-reference-validator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: lensetek (https://skillmd.com/u/lensetek)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lensetek/citation-and-reference-validator

---


# 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)*:
  ```bash
  python "<PATH_KE_SKILL>/scripts/validate_references.py" --input references.json --output report.json
  ```
  atau jalankan secara langsung untuk single DOI/Title:
  ```bash
  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:
  ```bash
  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.