resource-and-literature-validation

Validates URLs, YouTube videos, and academic citations while retrieving open-access PDFs via DOI lookup.

1|Updated Sep 1, 2026
One-click install
npx skills add https://github.com/nvtruongops/pi-guard --skill resource-and-literature-validation-nvtruongops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resource-and-literature-validation
Source: https://github.com/nvtruongops/pi-guard/tree/main/.agents/skills/resource-and-literature-validation
Command: npx skills add https://github.com/nvtruongops/pi-guard --skill resource-and-literature-validation-nvtruongops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Academic documents and research repositories often accumulate dead links, hallucinated YouTube video IDs, and paywalled DOI references that block readers. This Skill enforces a strict validation protocol so every URL, video, and paper citation in the PI-Guard repository is verified, accessible, and backed by an open-access full-text source. ## Core Features & Use Cases - Zero Dead Links Enforcement: Verifies every URL via HTTP GET/HEAD checks requiring HTTP 200/301/302 responses, and validates YouTube videos through the official oEmbed endpoint to confirm videos exist and are public. - Open-Access PDF Retrieval: Resolves DOIs through OpenAlex and Semantic Scholar APIs to automatically locate free full-text PDFs from arXiv or university repositories, preventing paywall-blocked citations. - Five-Step Academic Rigor Gate: Audits bibliographic provenance, venue/year accuracy, four-tier attribution, black-box scope compatibility, and local PDF archival with BibTeX logging. - Use Case: Before committing a research document citing an IEEE paper, run the verification script on the Markdown file to confirm all links return HTTP 200, then fetch the open-access PDF via the paper's DOI and add the dual-link citation format. ## Quick Start Ask the agent to verify all links in a Markdown file and find the open-access PDF for a given DOI using the repository's verification scripts.

Frequently Asked Questions about resource-and-literature-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a URL is valid before adding it to documentation?

Run the verify_resource_url.py script with the --url flag to perform an HTTP GET/HEAD check. The link is accepted only when it returns HTTP 200 or a valid 301/302 redirect, preventing dead or hallucinated links from entering the repository.

How to find a free open-access PDF from a DOI?

Pass the DOI to verify_resource_url.py with the --doi flag. The tool queries OpenAlex and Semantic Scholar APIs to extract a direct open-access PDF link from sources like arXiv or university repositories, avoiding paywalled publisher pages.

How do I verify a YouTube video link actually exists?

YouTube links are validated through the official oEmbed endpoint at youtube.com/oembed with the video ID. The video is accepted only when the API returns HTTP 200 with a title and author name, confirming it is public and not removed or private.

Can I audit all Markdown files in a repository for broken links at once?

Yes, run the audit_urls.py script to scan over 60 Markdown files using a ThreadPoolExecutor for parallel checking. It classifies working versus broken or paywalled URLs and lists the affected files for remediation.

What citation format should I use for paywalled academic papers?

Use the dual-linking standard: list the official DOI as inline code to avoid Cloudflare WAF blocks during automated checks, and pair it with a direct open-access PDF link from arXiv, OpenAlex, or Semantic Scholar so readers can access the full text.