science-search
Skill12 starsChanged 6 days agoMITView on GitHub
Search ~200 million scientific papers (OpenAlex titles and abstracts) by meaning or exact words, look up papers by DOI / OpenAlex ID / PMCID, find similar papers, and walk citation graphs through the free ScienceMadeReadable search API (no key). Use when a task requires scientific literature, finding evidence for claims, conducting literature reviews, citing peer-reviewed studies, or resolving DOIs. Triggers on: 'science search', '논문 검색', '과학 논문', '학술 자료', 'research paper', 'scientific study', 'find paper', 'DOI 검색', '의학 논문', '선행 연구'.
In this repository51 other files it gives its agents.
- agents.mdAGENTS.md
- .agents/skills/react-best-practices/AGENTS.mdAGENTS.md
- .agents/skills/react-native-skills/AGENTS.mdAGENTS.md
- .agents/skills/react-view-transitions/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- agent-initSkill
- agy-delegateSkill
- audit-docsSkill
- code-audit-expertSkill
- computer-diagnosisSkill
- create-builtin-toolSkill
- create-prSkill
- critique-builtin-toolSkill
- doc-auditorSkill
- docxSkill
- extract-log-debugSkill
- feature-refactor-proposalSkill
- gatekeeper-loopSkill
- harbor-harness-improvement-loopSkill
- harness-eval-loopSkill
- i18n-language-standardsSkill
- jobs-trace-analyzerSkill
- lean-builtin-tool-auditorSkill
- libragent-qualitySkill
- libr-delegateSkill
- libr-tool-e2e-harness-loopSkill
- modular-large-file-refactorSkill
- performance-auditSkill
- pptxSkill
- producer-loopSkill
- vercel-react-best-practicesSkill
- vercel-react-native-skillsSkill
- vercel-react-view-transitionsSkill
- readme-showcase-syncSkill
- refactor-builtin-toolSkill
- release-head-self-e2eSkill
- release-managerSkill
- review-local-changesSkill
- review-pr-commentsSkill
- setup-wizardSkill
- skill-creatorSkill
- soul-awakeningSkill
- sqlite-analyzerSkill
- sync-pending-approvalsSkill
- tool-creatorSkill
- trace-analyzerSkill
- trace-eval-loopSkill
- vitepress-doc-syncSkill
- worker-loopSkill
- x-cliSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 1 is distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Search ~200 million peer-reviewed papers and academic preprints across all fields of science.
- Very specific: line 20
If you only have a web fetching tool (read_url_content / HTTP GET), request the plain-text Markdown endpoint directly:
- Very specific: line 31
Run the bundled script using standard Python (python3, python, or uv run):
- Very specific: line 119
Step 1: Search with abstracts=false and k=10~20 to inspect titles, publication years, citation counts, and venues.
- Very specific: line 128
Always cite using the official DOI (https://doi.org/<doi>) or OpenAlex URL.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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
Science Search (ScienceMadeReadable)
Search ~200 million peer-reviewed papers and academic preprints across all fields of science.
- Base URL:
https://api.sciencemadereadable.com/api/data - Authentication: Free, read-only JSON over HTTPS, no API key required.
- Reference Doc:
GET https://api.sciencemadereadable.com/api/data/llms.txt
1. Quick Invocation (Cross-Platform)
Option A: Direct Web Fetch / Agent Fallback (No CLI Required)
If you only have a web fetching tool (read_url_content / HTTP GET), request the plain-text Markdown endpoint directly:
https://ask.sciencemadereadable.com/<question>- Spaces can be
%20or+(e.g.https://ask.sciencemadereadable.com/why%20do%20cats%20purr?k=10&abstracts=false) - Accepts standard query parameters:
k(1–100),year_from,year_to,type,open_access=true,abstracts=false.
Option B: Bundled Python Helper Script (Zero Dependencies)
Run the bundled script using standard Python (python3, python, or uv run):
# Semantic search with token-saving (no abstracts)
python scripts/search_science.py "effect of intermittent fasting on weight loss" --limit 10 --no-abstracts
# Keyword / Boolean search
python scripts/search_science.py '"gut microbiome" AND autism NOT mice' --limit 5
# Look up paper by DOI or OpenAlex ID
python scripts/search_science.py --work "10.1126/science.aan8048"
# Find similar papers
python scripts/search_science.py --similar "W2782456798" --limit 5
# Citation walk (what similar papers cite that this paper does not)
python scripts/search_science.py --walk "10.1126/science.aan8048"Option C: cURL / Shell
Bash (Linux / macOS):
B="https://api.sciencemadereadable.com/api/data"
# Semantic search
curl -sG "$B/search" --data-urlencode "q=effect of intermittent fasting on weight loss in adults" -d k=10 -d abstracts=false
# Keyword & boolean search
curl -sG "$B/search" --data-urlencode 'q="gut microbiome" AND (autism OR ASD) NOT mice' -d k=10 -d abstracts=false
# Paper lookup by DOI
curl -s "$B/works/10.1126/science.aan8048"
# Similar papers
curl -s "$B/similar/W2782456798?k=10&abstracts=false"
# Citation walk
curl -s "$B/walk?id=10.1126/science.aan8048"PowerShell (Windows):
$B = "https://api.sciencemadereadable.com/api/data"
# Semantic search
Invoke-RestMethod -Uri "$B/search?q=effect+of+intermittent+fasting+on+weight+loss+in+adults&k=10&abstracts=false"
# Paper lookup
Invoke-RestMethod -Uri "$B/works/10.1126/science.aan8048"2. API Endpoints Reference
| Endpoint | Method | Purpose | Key Parameters |
/search | GET | Search papers by meaning or exact keywords | q, mode (auto|semantic|keyword), k (1–100), year_from, year_to, type, open_access, abstracts (true|false) |
/search/{question} | GET | Plain-text Markdown output of search results | Same query options as /search |
/works/{ref} | GET | Full paper record by DOI, W-number, or PMCID | ref = DOI (10.xxx), OpenAlex ID (Wxxx), or PMCID (PMCxxx) |
/similar/{ref} | GET | Find papers closest in meaning to a specific paper | ref, k, year_from, year_to, abstracts |
/walk?id={ref} | GET | Citation walk: find literature that similar papers cite | id (DOI or W-number), k |
Key Result Fields
id: OpenAlex W-number (e.g.W2782456798)doi: Digital Object Identifiertitle: Paper titleyear/date: Publication dateauthors: Authors list (joined by" | ")venue/publisher: Journal or conference namecitations: Citation count at snapshot dateabstract: Paper abstract (ifabstracts=true)score: Cosine similarity (semantic) or BM25 score (keyword)junk: Likelihood (0.0–1.0) that the item is spam or non-scholarlyopenalex: OpenAlex URL for citation
3. Best Practices for AI Agents
- Academic Phrasing Optimization:
- Transform informal questions into academic/scientific phrasing before searching.
- Example: Instead of
"how to cure insomnia", search for"non-pharmacological interventions for chronic insomnia in adults". This drastically increases semantic matching precision.
- Token Efficiency (Screening Pattern):
- Step 1: Search with
abstracts=falseandk=10~20to inspect titles, publication years, citation counts, and venues. - Step 2: Select the top 1~3 most relevant papers and call
/works/{id}or re-query withabstracts=trueonly for those specific papers.
- Step 1: Search with
- Snowballing Literature Reviews:
- Identify 1 seminal paper $\rightarrow$ call
/similar/{id}to discover peer research $\rightarrow$ call/walk?id={doi}to capture foundational works cited across the field.
- Identify 1 seminal paper $\rightarrow$ call
- Rate Limits & Etiquette:
- Limit: 30 requests per minute per IP address.
- Batch parameters into a single request (e.g.
k=30once rather than multiplek=5calls). - Respect HTTP 429: read the
Retry-Afterheader orretry_afterJSON response field and sleep before retrying.
- Citing Papers:
- Always cite using the official DOI (
https://doi.org/<doi>) or OpenAlex URL. - To guide human users to an interactive reading view:
https://sciencemadereadable.com/?work=<doi>.
- Always cite using the official DOI (
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.

