← Back to Skills Marketplace
tokisakix

swiftscholar-skill

by Tokisakix · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install swiftscholar-skill
Description
Integrates the SwiftScholar HTTP API for searching, submitting, and analyzing academic papers. Use when the user wants to search literature, submit PDFs/URLs for parsing, retrieve analyses, manage favorites, or inspect SwiftScholar account usage programmatically.
Usage Guidance
Before installing or enabling this skill: 1) Recognize the SKILL.md requires a SwiftScholar API key (Authorization: Bearer <SWIFTSCHOLAR_API_KEY>), but the skill metadata does not declare that requirement — confirm with the skill author or registry how/where the key must be provided. 2) Do not paste secrets into chat; place the API key only into a secured execution environment (env var or tool config) the agent will use. 3) Be cautious about uploading sensitive PDFs: the skill supports pdfBase64 or multipart uploads that will send file contents to swiftscholar.net. Prefer submitting public URLs or removing sensitive information before upload. 4) Verify the API base URL (https://www.swiftscholar.net) and review SwiftScholar's privacy/retention policy if you will send user data. 5) If you cannot confirm where the API key is stored or how the agent obtains it, treat the skill as untrusted and do not provide credentials.
Capability Analysis
Type: OpenClaw Skill Name: swiftscholar-skill Version: 1.0.0 The OpenClaw AgentSkills skill bundle for 'swiftscholar-skill' is benign. The `SKILL.md` provides clear, well-structured instructions for an AI agent to interact with the SwiftScholar HTTP API at `https://www.swiftscholar.net` for academic paper management. It explicitly instructs the agent not to expose the `SWIFTSCHOLAR_API_KEY` in natural language responses, which is a positive security measure. There is no evidence of prompt injection attempts, unauthorized data exfiltration beyond the stated API interaction, malicious command execution, or persistence mechanisms. All files consistently describe the intended functionality without any hidden or harmful directives.
Capability Assessment
Purpose & Capability
The skill's name, description, and SKILL.md all align: it documents how to call the SwiftScholar HTTP API for searching, submitting, analyzing papers, and managing favorites. However, the SKILL.md explicitly describes Authorization: Bearer <SWIFTSCHOLAR_API_KEY> while the registry metadata lists no required environment variables or primary credential — this is an incoherence between stated capability and declared requirements.
Instruction Scope
Instructions focus on HTTP endpoints under https://www.swiftscholar.net and on submitting/searching/analysis flows. They do not instruct arbitrary file-system or unrelated network access beyond submitting PDFs/URLs to SwiftScholar. The skill does allow both pdfBase64 and multipart file upload modes (expected for this purpose), so be mindful that user-supplied PDFs could be transmitted to the external API.
Install Mechanism
This is instruction-only with no install spec and no code files — low install risk. Nothing is downloaded or written by a packaged installer.
Credentials
SKILL.md requires a bearer token header (SWIFTSCHOLAR_API_KEY) for API calls and warns not to reveal it in natural language, yet the skill metadata lists no required env vars or primary credential. The missing declaration is a red flag: callers/administrators may not realize an API key is needed or where the agent will obtain it. No other unrelated credentials are requested.
Persistence & Privilege
always is false, the skill is user-invocable and may be invoked autonomously by the agent (platform default). There is no indication the skill modifies other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install swiftscholar-skill
  3. After installation, invoke the skill by name or use /swiftscholar-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
SwiftScholar Skill 1.0.0 – Initial Release - Integrates the SwiftScholar HTTP API for searching, submitting, and analyzing academic papers. - Supports keyword and semantic (vector) search, paper submission via URL or PDF, and batch URL submission. - Enables retrieval of structured markdown analysis, raw markdown, and guarded PDF download links for papers. - Allows management of favorites, favorite folders, and paper tags, as well as inspection of usage, parse quotas, and available analysis models. - Follows strict guidelines for authentication and secure API key handling.
Metadata
Slug swiftscholar-skill
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is swiftscholar-skill?

Integrates the SwiftScholar HTTP API for searching, submitting, and analyzing academic papers. Use when the user wants to search literature, submit PDFs/URLs for parsing, retrieve analyses, manage favorites, or inspect SwiftScholar account usage programmatically. It is an AI Agent Skill for Claude Code / OpenClaw, with 1114 downloads so far.

How do I install swiftscholar-skill?

Run "/install swiftscholar-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is swiftscholar-skill free?

Yes, swiftscholar-skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does swiftscholar-skill support?

swiftscholar-skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created swiftscholar-skill?

It is built and maintained by Tokisakix (@tokisakix); the current version is v1.0.0.

💬 Comments