← Back to Skills Marketplace
tanis90

Academic Reader

by tanis90 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install academic-reader
Description
PDF to Markdown converter - extract text, tables and formulas from PDF files to clean Markdown. Use when converting PDF documents, extracting PDF content, pa...
README (SKILL.md)

\r \r

Academic Reader - Scientific Paper Parser\r

\r Convert PDF files to clean Markdown using MinerU Open API. No API key required.\r \r

Quick Start\r

\r

# Academic Reader - Scientific Paper Parser\r
mineru-open-api flash-extract report.pdf\r
\r
# Academic Reader - Scientific Paper Parser\r
mineru-open-api flash-extract https://cdn-mineru.openxlab.org.cn/demo/example.pdf\r
\r
# Academic Reader - Scientific Paper Parser\r
mineru-open-api flash-extract report.pdf -o ./output/\r
\r
# Academic Reader - Scientific Paper Parser\r
mineru-open-api flash-extract report.pdf --pages 1-10\r
```\r
\r
## Language Rule\r
\r
You MUST reply to the user in the SAME language they use. This is non-negotiable.\r
\r
## Capabilities\r
\r
- Extracts text, tables, and formulas from PDF\r
- Supports both local files and URLs directly\r
- Page range selection with `--pages`\r
- Language hint with `--language` (default: `ch`, use `en` for English)\r
- No API key, no signup, no authentication\r
- Max 10MB / 20 pages per document\r
\r
## When to Use\r
\r
- User asks to "read", "extract", "convert", or "parse" a PDF\r
- User shares a PDF file or PDF link and asks for its content\r
- User wants to summarize or analyze a PDF document\r
- User needs PDF content in Markdown format\r
\r
## CLI Reference\r
\r
Run `mineru-open-api flash-extract --help` for all available options.\r
\r
## Data Flow\r
\r
`flash-extract` sends the document to the MinerU API (mineru.net) for processing and returns Markdown. This is a stateless API call — no account, no persistent storage. MinerU is an open-source project by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU\r
\r
## Notes\r
\r
- Output is Markdown only; images/tables/formulas may be replaced with placeholders\r
- For larger files (up to 200MB/600 pages) or precision extraction with full assets, use `mineru-open-api extract` (requires auth via `mineru-open-api auth`)\r
- If the CLI cannot be installed via npm/uv/go, download it from https://mineru.net/ecosystem?tab=cli\r
Usage Guidance
This skill appears to do what it says, but it uploads documents to the MinerU API (mineru.net) for processing. Before installing or using it, avoid sending sensitive or confidential PDFs; verify the mineru-open-api package source (npm page and the GitHub repo referenced), inspect package contents or source code if possible, and install/run it in a controlled environment (or sandbox) if you have privacy concerns. Check the CLI's version, publisher, and checksum, and prefer an on-device extractor if you cannot accept external upload of your documents.
Capability Analysis
Type: OpenClaw Skill Name: academic-reader Version: 1.0.0 The skill facilitates PDF-to-Markdown conversion by uploading local documents to a remote third-party API (mineru.net). While this aligns with the stated purpose of the 'Academic Reader,' the automated transmission of potentially sensitive user files to an external endpoint (OpenDataLab/Shanghai AI Lab) constitutes a high-risk data flow. The SKILL.md also includes a 'non-negotiable' behavioral instruction regarding language usage, but no evidence of intentional malice, such as credential theft or obfuscated payloads, was found.
Capability Assessment
Purpose & Capability
The name/description (PDF to Markdown converter) aligns with the declared binary (mineru-open-api) and the SKILL.md examples (mineru-open-api flash-extract). Required binaries and install methods are consistent with the stated purpose.
Instruction Scope
SKILL.md instructs using the mineru-open-api CLI to send local files or URLs to the MinerU service for extraction. It does not direct the agent to read unrelated files, environment variables, or system configuration. The documented data flow explicitly sends the document to mineru.net, which is consistent with a cloud-based extraction tool.
Install Mechanism
Installers are npm / uv / go package installs for a CLI named mineru-open-api. Using public package managers is typical but does involve executing third-party code on the host. No direct-download URLs or obscure hosts are used in the install spec, which lowers but does not eliminate install risk.
Credentials
The skill requests no environment variables, credentials, or config paths. That is proportional for a tool that claims 'no API key required.' The only sensitive action is uploading user-provided PDFs to an external API, which is justified by the stated functionality but has privacy implications.
Persistence & Privilege
always:false and no config paths or cross-skill config modifications are requested. The skill does not request permanent presence or elevated platform privileges beyond installing/using its CLI binary.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install academic-reader
  3. After installation, invoke the skill by name or use /academic-reader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Academic Reader 1.0.0 - Initial release: convert PDF files to clean Markdown with MinerU Open API. - Extracts text, tables, and formulas from local PDFs or URLs. - Supports page range selection and language hints. - No API key, signup, or authentication required. - Limit of 10MB or 20 pages per document. - Output is Markdown only; images/tables/formulas may be replaced with placeholders.
Metadata
Slug academic-reader
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Academic Reader?

PDF to Markdown converter - extract text, tables and formulas from PDF files to clean Markdown. Use when converting PDF documents, extracting PDF content, pa... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.

How do I install Academic Reader?

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

Is Academic Reader free?

Yes, Academic Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Academic Reader support?

Academic Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Academic Reader?

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

💬 Comments