Skip to content

marciob/skill-research-papers / research-papers

research-papers

Verified

Research, filter, compare, and synthesize scientific papers across arXiv, OpenAlex, ACM Digital Library, DBLP, Semantic Scholar, PubMed, SSRN, and publisher landing pages. Use when the agent needs to do literature discovery, find top or recent papers, build a reading list, compare methods or results, trace citation graphs, summarize evidence, or produce properly attributed paper recommendations and literature reviews.

FileKindSize
SKILL.mdskill md14.5 KB
agents/openai.yamlconfig221 B
references/api-playbook.mdmarkdown16.9 KB
references/output-shapes.mdmarkdown2.5 KB
references/screening-rubric.mdmarkdown3.0 KB
references/smoke-tests.mdmarkdown4.4 KB
references/source-guides.mdmarkdown4.9 KB
scripts/.gitignoreother7 B
scripts/fetch_and_parseexecutablescript990 B
scripts/fetch_and_parse.pyexecutablescript52.0 KB
scripts/requirements.txtmanifest496 B
scripts/smoke-test-sources.shexecutablescript5.8 KB

scripts/smoke-test-sources.sh

View on GitHub
#!/usr/bin/env bash

set -u

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"

if [[ -f "${REPO_ROOT}/.env" ]]; then
  set -a
  # shellcheck disable=SC1091
  source "${REPO_ROOT}/.env"
  set +a
fi

USER_AGENT="${USER_AGENT:-research-papers-skill/1.0}"
OPENALEX_API_KEY="${OPENALEX_API_KEY:-}"
SEMANTIC_SCHOLAR_API_KEY="${SEMANTIC_SCHOLAR_API_KEY:-}"
NCBI_API_KEY="${NCBI_API_KEY:-}"
NCBI_EMAIL="${NCBI_EMAIL:-}"
NCBI_TOOL="${NCBI_TOOL:-research-papers-skill}"

pass_count=0
warn_count=0
fail_count=0

report() {
  printf '%-22s %-5s %s\n' "$1" "$2" "$3"
}

mark_pass() {
  pass_count=$((pass_count + 1))
  report "$1" "PASS" "$2"
}

mark_warn() {
  warn_count=$((warn_count + 1))
  report "$1" "WARN" "$2"
}

mark_fail() {
  fail_count=$((fail_count + 1))
  report "$1" "FAIL" "$2"
}

fetch_capture() {
  local __var_name="$1"
  shift
  local response

  if ! response="$(curl -sS -A "$USER_AGENT" "$@" 2>&1)"; then
    printf -v "$__var_name" '%s' "$response"
    return 1
  fi

  printf -v "$__var_name" '%s' "$response"
  return 0
}

echo "Smoke test date: $(date -u '+%Y-%m-%dT%H:%M:%SZ')"
echo

if fetch_capture arxiv_response 'https://export.arxiv.org/api/query?search_query=all:graph+neural+network&start=0&max_results=1'; then
  if [[ "$arxiv_response" == *"<feed"* && "$arxiv_response" == *"<entry>"* ]]; then
    mark_pass "arXiv" "query endpoint returned Atom feed"
  else
    mark_fail "arXiv" "query endpoint did not return the expected Atom structure"
  fi
else
  mark_fail "arXiv" "curl failed: $arxiv_response"
fi

openalex_url='https://api.openalex.org/works?search=graph%20neural%20network&per-page=1&select=id,title,doi,publication_year'
if [[ -n "$OPENALEX_API_KEY" ]]; then
  openalex_url="${openalex_url}&api_key=${OPENALEX_API_KEY}"
fi
if fetch_capture openalex_response "$openalex_url"; then
  if [[ "$openalex_response" == *'"results"'* && "$openalex_response" == *'"meta"'* ]]; then
    mark_pass "OpenAlex" "works endpoint returned JSON results"
  else
    mark_fail "OpenAlex" "works endpoint did not return the expected JSON structure"
  fi
else
  mark_fail "OpenAlex" "curl failed: $openalex_response"
fi

if fetch_capture dblp_author_response 'https://dblp.org/search/author/api?q=goodfellow&format=json&h=1'; then
  if [[ "$dblp_author_response" == *'"hits"'* && "$dblp_author_response" == *'"status"'* ]]; then
    mark_pass "DBLP author" "author endpoint returned JSON hits"
  else
    mark_fail "DBLP author" "author endpoint did not return the expected JSON structure"
  fi
else
  mark_fail "DBLP author" "curl failed: $dblp_author_response"
fi

if fetch_capture dblp_publ_response 'https://dblp.org/search/publ/api?q=test&format=json&h=1'; then
  if [[ "$dblp_publ_response" == *'"hits"'* && "$dblp_publ_response" == *'"status"'* ]]; then
    mark_pass "DBLP publ" "publication endpoint returned JSON hits"
  elif [[ "$dblp_publ_response" == *'dblp: error 500'* ]]; then
    mark_warn "DBLP publ" "publication endpoint returned server-side 500"
  else
    mark_fail "DBLP publ" "publication endpoint returned an unexpected response"
  fi
else
  mark_fail "DBLP publ" "curl failed: $dblp_publ_response"
fi

semantic_scholar_url='https://api.semanticscholar.org/graph/v1/paper/search?query=graph%20neural%20network&limit=1&fields=title,year,url'
if [[ -n "$SEMANTIC_SCHOLAR_API_KEY" ]]; then
  if ! fetch_capture semantic_scholar_response -H "x-api-key: ${SEMANTIC_SCHOLAR_API_KEY}" "$semantic_scholar_url"; then
    mark_fail "Semantic Scholar" "curl failed: $semantic_scholar_response"
    semantic_scholar_response=""
  fi
else
  if ! fetch_capture semantic_scholar_response "$semantic_scholar_url"; then
    mark_fail "Semantic Scholar" "curl failed: $semantic_scholar_response"
    semantic_scholar_response=""
  fi
fi
if [[ -z "$semantic_scholar_response" ]]; then
  :
elif [[ "$semantic_scholar_response" == *'"data"'* ]]; then
  mark_pass "Semantic Scholar" "paper search returned JSON data"
elif [[ "$semantic_scholar_response" == *'"429"'* || "$semantic_scholar_response" == *'Too Many Requests'* || "$semantic_scholar_response" == *'"code": "429"'* ]]; then
  mark_warn "Semantic Scholar" "request was throttled; use an API key and retry logic"
else
  mark_fail "Semantic Scholar" "paper search returned an unexpected response"
fi

pubmed_url='https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=pubmed&term=graph%20neural%20network&retmax=1&retmode=json'
pubmed_url="${pubmed_url}&tool=${NCBI_TOOL}"
if [[ -n "$NCBI_EMAIL" ]]; then
  pubmed_url="${pubmed_url}&email=${NCBI_EMAIL}"
fi
if [[ -n "$NCBI_API_KEY" ]]; then
  pubmed_url="${pubmed_url}&api_key=${NCBI_API_KEY}"
fi
if fetch_capture pubmed_response "$pubmed_url"; then
  if [[ "$pubmed_response" == *'"esearchresult"'* ]]; then
    mark_pass "PubMed" "ESearch returned JSON results"
  else
    mark_fail "PubMed" "ESearch did not return the expected JSON structure"
  fi
else
  mark_fail "PubMed" "curl failed: $pubmed_response"
fi

if fetch_capture acm_response 'https://dl.acm.org/action/doSearch?AllField=graph%20neural%20network'; then
  if [[ "$acm_response" == *'Just a moment...'*
     || "$acm_response" == *'Enable JavaScript and cookies to continue'* ]]; then
    mark_warn "ACM DL" "search page returned a bot challenge"
  else
    mark_pass "ACM DL" "search page returned content"
  fi
else
  mark_fail "ACM DL" "curl failed: $acm_response"
fi

if fetch_capture ssrn_response 'https://ssrn.com/abstract=2250500'; then
  if [[ "$ssrn_response" == *'Just a moment...'*
     || "$ssrn_response" == *'Enable JavaScript and cookies to continue'* ]]; then
    mark_warn "SSRN" "abstract page returned a bot challenge"
  else
    mark_pass "SSRN" "abstract page returned content"
  fi
else
  mark_fail "SSRN" "curl failed: $ssrn_response"
fi

echo
echo "Summary: pass=${pass_count} warn=${warn_count} fail=${fail_count}"

if [[ "$fail_count" -gt 0 ]]; then
  exit 1
fi
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall