skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
lensetek/research-agent-skills-collection60 installs

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.

How do I install this agent skill?

npx skills add https://github.com/lensetek/research-agent-skills-collection --skill citation-and-reference-validator
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is an academic utility designed to validate the authenticity of citations and references. It uses a bundled Python script to cross-reference metadata against reputable academic databases (Crossref and OpenAlex) and implements explicit anti-hallucination workflows to ensure scientific integrity.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

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 NaskahPaper Rujukan (Sitasi & DOI)Kutipan Verbatim Asli dari Paper (Evidence Snippet)Status Dukungan KontekstualCatatan 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.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/lensetek/research-agent-skills-collection/citation-and-reference-validator">View citation-and-reference-validator on skillZs</a>