openJiuwen-ai/sciencediscovery / skills/literature-searcher
literature-searcher
VerifiedUse this skill when a research workflow needs verified academic source retrieval through literature-search MCP interfaces available in the current session before evidence extraction. Discovers and selects relevant interfaces adaptively, then produces deduplicated literature JSON and coverage notes. Not for full-text reading, evidence extraction, final report writing, or workflow coordination.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.5 KB |
| scripts/arxiv_search.py | script | 13.5 KB |
| scripts/crossref_search.py | script | 13.6 KB |
| scripts/deduplicate.py | script | 10.0 KB |
| scripts/external_urls.py | script | 3.1 KB |
| scripts/output_utils.py | script | 5.9 KB |
| scripts/pubmed_search.py | script | 14.3 KB |
| scripts/query_preprocessor.py | script | 9.3 KB |
| scripts/requirements.txt | manifest | 633 B |
scripts/external_urls.py
View on GitHub# Copyright (C) 2026-2026 Huawei Technologies Co., Ltd
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Load the repository's authoritative external URL configuration."""
from __future__ import annotations
import json
import os
from functools import lru_cache
from pathlib import Path
from typing import Any
_CONFIG_RELATIVE_PATH = Path("config/external-urls.json")
def _candidate_paths() -> list[Path]:
candidates: list[Path] = []
configured = os.environ.get("SCIENCE_AGENT_EXTERNAL_URLS_PATH", "").strip()
if configured:
candidates.append(Path(configured).expanduser().resolve())
candidates.append((Path.cwd() / _CONFIG_RELATIVE_PATH).resolve())
for parent in Path(__file__).resolve().parents:
candidates.append(parent / _CONFIG_RELATIVE_PATH)
return list(dict.fromkeys(candidates))
@lru_cache(maxsize=1)
def _load_config() -> dict[str, Any]:
path = next((candidate for candidate in _candidate_paths() if candidate.is_file()), None)
if path is None:
raise RuntimeError(
"External URL configuration not found; set SCIENCE_AGENT_EXTERNAL_URLS_PATH "
f"or provide {_CONFIG_RELATIVE_PATH}"
)
try:
config = json.loads(path.read_text(encoding="utf-8"))
except (OSError, json.JSONDecodeError) as error:
raise RuntimeError(f"Failed to load external URL configuration at {path}: {error}") from error
if not isinstance(config, dict):
raise RuntimeError(f"External URL configuration at {path} must contain a JSON object")
return config
def _config_value(key: str) -> Any:
value: Any = _load_config()
for segment in key.split("."):
if not isinstance(value, dict) or segment not in value:
raise RuntimeError(f"External URL configuration is missing required key: {key}")
value = value[segment]
return value
def external_url(key: str) -> str:
value = _config_value(key)
if not isinstance(value, str) or not value:
raise RuntimeError(f"External URL configuration key {key} must be a non-empty string")
return value
def external_url_list(key: str) -> tuple[str, ...]:
value = _config_value(key)
if not isinstance(value, list) or any(not isinstance(item, str) or not item for item in value):
raise RuntimeError(f"External URL configuration key {key} must be an array of non-empty strings")
return tuple(value)
def format_external_url(key: str, **parameters: str | int) -> str:
template = external_url(key)
try:
return template.format_map(parameters)
except KeyError as error:
raise RuntimeError(f"External URL template {key} requires parameter: {error.args[0]}") from error
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |