← Back to Skills Marketplace
steventsao

OkraPDF

by Steven Tsao · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
113
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install okra
Description
OkraPDF — upload PDFs, read extracted content, ask questions, extract structured data, and manage collections. Covers MCP, CLI, and HTTP.
Usage Guidance
This appears to be a legitimate PDF-extraction/QA integration, but take these precautions before installing or using it: 1) Confirm the remote domain (api.okrapdf.com / okrapdf.com) is one you trust and review their privacy/TOS because uploaded PDFs will be sent to that service. 2) The SKILL.md expects an API key (OKRA_API_KEY) and tells you to store it in agent config or environment; the skill metadata did not declare this — do not paste sensitive or org-confidential documents until you verify the provider. 3) The CLI install uses npm - audit the npm package 'okrapdf' (check publisher, version history, and repository/source code) before global installation. 4) If you must proceed, create a least-privilege API key, test with non-sensitive files, and consider running the CLI in a sandboxed environment. 5) If you need higher assurance, ask the publisher for source/release links or a homepage and request that required env vars and install steps be declared in the registry metadata.
Capability Analysis
Type: OpenClaw Skill Name: okra Version: 1.0.0 The skill bundle provides comprehensive documentation and tool definitions for OkraPDF, a service for PDF extraction and analysis. It includes instructions for MCP, CLI, and HTTP interfaces, allowing an agent to upload documents, query content, and extract structured data. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found; the content is entirely consistent with its stated purpose of document processing. (IOC: api.okrapdf.com)
Capability Assessment
Purpose & Capability
SKILL.md describes a PDF-upload + extraction/chat service (MCP, CLI, HTTP) and all instructions map to that purpose. However, the registry metadata lists no required credentials or env vars while the README clearly expects an API key (OKRA_API_KEY / 'YOUR_API_KEY'). This mismatch is a minor incoherence.
Instruction Scope
Instructions are scoped to uploading/reading/asking about PDFs via api.okrapdf.com, installing a CLI, and adding an MCP entry. They explicitly instruct modifying user agent config files (~/.claude/mcp.json, .cursor/mcp.json) and installing a global npm package; those actions are within the stated purpose but are side-effects the user should be aware of and which are not declared in the registry metadata.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md tells users to run 'npm install -g okrapdf' and to set an API key. Installing a global npm package carries normal supply-chain risk; the skill does not provide a vetted install source or manifest entry for this step.
Credentials
The service reasonably requires an API key (Authorization: Bearer), and the SKILL.md references OKRA_API_KEY and a user API key. That credential is proportional to the service, but the skill metadata did not declare required env vars or the primary credential — an inconsistency worth noting.
Persistence & Privilege
The skill does not request always: true and does not require system-wide privileges. It asks the user to add an MCP server entry and to install a CLI, which is normal for an integration; these are not excessive privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install okra
  3. After installation, invoke the skill by name or use /okra
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Unified skill — MCP, CLI, HTTP organized by workflow
Metadata
Slug okra
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is OkraPDF?

OkraPDF — upload PDFs, read extracted content, ask questions, extract structured data, and manage collections. Covers MCP, CLI, and HTTP. It is an AI Agent Skill for Claude Code / OpenClaw, with 113 downloads so far.

How do I install OkraPDF?

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

Is OkraPDF free?

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

Which platforms does OkraPDF support?

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

Who created OkraPDF?

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

💬 Comments