research-lookup

Look up current research information via Parallel Chat API or Perplexity academic search.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill research-lookup-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-lookup
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/research-lookup
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill research-lookup-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, requests, and includes scripts (resource) components.

What problem does it solve? Finding current, well-cited research information requires manually searching multiple databases and verifying source quality. This Skill automates research lookups by routing queries to the appropriate backend—Parallel Chat API for general research or Perplexity sonar-pro-search for academic paper searches—and returns cited, structured results. ## Core Features & Use Cases - Automatic Backend Routing: Detects academic keywords (papers, DOI, peer-reviewed, systematic review) and routes to Perplexity; all other queries go to the Parallel Chat API core model. - Quality-Prioritized Paper Search: Ranks papers by citation count, venue tier (Nature, Science, NeurIPS, etc.), and author reputation, returning 5-8 citations with DOIs. - Mandatory Result Archiving: Saves every lookup to a sources/ folder with preserved citations, URLs, and DOIs for reproducibility and reuse. - Use Case: While writing a scientific paper's introduction, ask for recent advances in your topic; the Skill returns a cited research report saved to sources/research_<topic>.md for later reference. ## Quick Start Set the PARALLEL_API_KEY and OPENROUTER_API_KEY environment variables, then ask the assistant to research recent advances in your topic and save the results to the sources folder.

Frequently Asked Questions about research-lookup

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

FAQPage Schema
How do I look up recent research papers with citations?

Run research_lookup.py with a query containing academic keywords like "find papers" or "systematic review" to route to Perplexity sonar-pro-search. Results include 5-8 papers with authors, journals, years, and DOIs, prioritized by citation count and venue tier.

What is the difference between the Parallel and Perplexity backends?

The Parallel Chat API core model handles general research, market data, and technical questions with multi-source markdown reports. Perplexity sonar-pro-search handles academic-specific queries like paper searches and DOI lookups using scholarly search mode.

Which API keys does the research lookup tool require?

Set PARALLEL_API_KEY for the primary Parallel Chat API backend and OPENROUTER_API_KEY for Perplexity academic searches. At least one key must be present; if one backend's key is missing, the tool falls back to the other.

Can I force a specific backend instead of automatic routing?

Yes, pass --force-backend parallel or --force-backend perplexity on the command line, or set force_backend when constructing the ResearchLookup class. This overrides the keyword-based automatic routing logic.

Why did my research lookup fail with an API key error?

The tool raises an error when neither PARALLEL_API_KEY nor OPENROUTER_API_KEY is set in the environment. Export at least one key before running, and confirm your OpenRouter account has credits and access to Perplexity models.

What are the limitations of automated research lookup?

Parallel core model queries can take up to 5 minutes for complex topics, and Perplexity cannot access paywalled full text or proprietary databases. Both backends depend on their respective API availability and rate limits.