paper-download-browser
Skill3 starsChanged 3 months agoMITView on GitHub
Download scholarly papers through a real browser when publisher pages, institutional login, redirects, or JavaScript prevent a direct fetch. Use only for open-access content or access the user is authorized to use. Never bypass paywalls, CAPTCHAs, authentication, rate limits, or other access controls.
In this repository6 other files it gives its agents.
- browserSkill
- cite-reviewSkill
- literature-surveySkill
- literature-writingSkill
- overleaf-setupSkill
- paper-reproduceSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 9 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use this skill when a DOI or publisher page is reachable but direct HTTP download is insufficient because navigation, institutional access, …
- Very specific: line 12
Before operating the browser, load the browser skill and follow its session and human-handoff rules.
- Distinctive: line 23
If the request is ambiguous, resolve the paper identity before downloading.
- Distinctive: line 34
Do not treat access failure as a reason to search for unauthorized copies.
- Distinctive: line 41
If authentication or verification appears, follow the human-handoff rule.
- Distinctive: line 42
After access is established, inspect the page and recent network requests to identify the legitimate document URL and response type.
- Distinctive: line 43
Prefer a direct download when the discovered URL is openly retrievable without exporting session credentials.
- Very specific: line 46
Do not declare success merely because a URL ends in .pdf.
- Distinctive: line 58
Keep supplementary files distinct, for example:
- Distinctive: line 64
Do not attach a supplement in place of the article PDF.
- Distinctive: line 68
Check all of the following:
- Very specific: line 78
If identity cannot be verified, keep the file out of the canonical papers/ path or mark the attempt failed.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Browser-assisted Paper Download
Obtain the exact paper the user requested and save a verified local PDF without weakening or evading access controls.
Use this skill when a DOI or publisher page is reachable but direct HTTP download is insufficient because navigation, institutional access, redirects, consent screens, or JavaScript are involved. For ordinary open PDF URLs, download directly without browser automation.
Before operating the browser, load the browser skill and follow its session and human-handoff rules.
Resolve the target
Record enough identity to detect a wrong download:
- DOI, PMID, arXiv id, or canonical landing URL;
- exact or normalized title;
- first author and year when available;
- requested version, such as version of record, accepted manuscript, preprint, or supplementary information.
If the request is ambiguous, resolve the paper identity before downloading. Do not silently substitute a similarly titled paper, a correction, an editorial, or supplementary material for the article.
Choose the least privileged route
Try routes in this order, stopping at the first legitimate success:
- A known direct open-access PDF URL.
- The DOI or publisher landing page's explicit PDF/download control.
- A legitimate open repository linked from the record, such as a publisher repository, PubMed Central, arXiv, or an institutional repository.
- The publisher route after the user completes an authorized institutional or personal login in the browser.
Do not treat access failure as a reason to search for unauthorized copies. When no permitted route succeeds, report the access status and preserve the canonical URL so the user can obtain the paper through a librarian, document-delivery service, or another authorized channel.
Browser procedure
- Open an isolated browser session and retain its session id.
- Navigate to the canonical record.
- Inspect the page snapshot before clicking. Use the page's real PDF, full-text, repository, or download control; do not guess hidden endpoints.
- If authentication or verification appears, follow the human-handoff rule.
- After access is established, inspect the page and recent network requests to identify the legitimate document URL and response type.
- Prefer a direct download when the discovered URL is openly retrievable without exporting session credentials. Otherwise use the visible browser's normal download control.
- Close the browser session when the attempt is complete or blocked.
Do not declare success merely because a URL ends in .pdf; publisher endpoints often return HTML login pages, consent pages, or error documents with a PDF-looking URL.
Save consistently
For a literature-review workspace, save the article as:
review/papers/<bibkey>.pdfUse the exact BibTeX key that will appear in review/manuscript/references.bib. If no key exists yet, derive a stable provisional key, create or update the BibTeX record, and keep the PDF stem identical to that key. Do not overwrite an existing file unless its identity has been checked and the user asked to replace it.
Keep supplementary files distinct, for example:
review/papers/<bibkey>-supplement.pdfDo not attach a supplement in place of the article PDF.
Verify before reporting success
Check all of the following:
- the saved file exists and is non-empty;
- its content is a PDF rather than an HTML or text response;
- it opens or can be parsed as a PDF;
- title, author, DOI, or other internal metadata matches the requested paper;
- it is the requested article version or is clearly labelled otherwise;
- the final filename follows the BibTeX-key convention;
- an existing file was not unintentionally replaced.
If identity cannot be verified, keep the file out of the canonical papers/ path or mark the attempt failed. Never let an uncertain download become evidence for a proposition.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

