← Back to Skills Marketplace
314
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pdf2markdown
Description
Convert PDF and image documents to clean Markdown via the PDF2Markdown CLI. Use when the user wants to extract text from PDFs, convert PDFs to markdown, pars...
Usage Guidance
This skill appears to wrap an external CLI/service (pdf2markdown.io) which will require an API key and will likely upload documents to that service. Before installing or running it: 1) Verify the npm package (pdf2markdown-cli) and the domain (pdf2markdown.io) are legitimate and review their privacy/TOS to understand how uploaded documents are handled. 2) Expect to set PDF2MARKDOWN_API_KEY — treat it as sensitive and prefer npx (no global install) if you want to avoid changing system state. 3) Don't run any 'setup skills' or 'install to agents' commands unless you trust the package: those steps can modify agent/skill directories. 4) Test with non-sensitive documents first. 5) Ask the publisher to update the skill metadata to declare PDF2MARKDOWN_API_KEY (primaryEnv) and explicitly document any agent-directory modifications — that will remove the main coherence concern.
Capability Analysis
Type: OpenClaw Skill
Name: pdf2markdown
Version: 0.1.0
The skill bundle facilitates PDF conversion but includes high-risk installation instructions in rules/install.md, specifically the use of `npx -y pdf2markdown-cli init -y` for automated remote code execution and a `setup skills` command designed to modify the configurations of multiple other AI agents (e.g., Cursor, Windsurf, Claude). While the provided security guidelines in rules/security.md suggest some defensive practices like gitignoring output, the CLI's capability for cross-application modification and the automated installation of remote packages are high-risk behaviors that warrant caution.
Capability Assessment
Purpose & Capability
The declared purpose (convert PDFs/images to Markdown) matches the CLI commands and options in SKILL.md and the included docs. However, the SKILL.md and rules reference an API key (PDF2MARKDOWN_API_KEY) and require the CLI to be 'pre-installed and authenticated', but the registry metadata lists no required environment variables or primary credential — a clear metadata/instruction mismatch.
Instruction Scope
Instructions stay focused on parsing and output handling, advising file-based output and incremental reads. They also instruct running commands that will upload/parse files via the external CLI (expected). A notable instruction is the CLI's 'setup skills' command which claims to install into detected agent directories (e.g., .cursor/skills, .opencode/skills) — this implies the CLI may modify local agent files, which is beyond simple PDF parsing and worth scrutiny before running.
Install Mechanism
There is no install spec in the registry (instruction-only skill), but rules/install.md suggests installing via npm/pnpm/yarn or using npx for one-off use. The referenced package (pdf2markdown-cli on npm) and docs URL look consistent; there's no arbitrary download URL or archive extraction. The absence of an official install entry in the skill metadata while providing full install instructions in included files is an inconsistency to be aware of.
Credentials
The runtime docs explicitly reference PDF2MARKDOWN_API_KEY (and login commands), which is the credential required to use the CLI and the external service. Yet the skill metadata declares no required env vars or primary credential. That mismatch is problematic because users won't see the credential requirement at install/permission time. No unrelated credentials are requested, but an API key is clearly required in practice and should be declared.
Persistence & Privilege
The skill itself is not 'always' included and doesn't request elevated platform privileges. However, the install docs instruct the CLI to 'install skills' into multiple detected agents and specific agent directories. If followed, those commands could change agent configuration folders or deploy code into local agent skill directories — this is a persistence/privilege consideration users should understand before running the install steps.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pdf2markdown - After installation, invoke the skill by name or use
/pdf2markdown - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the pdf2markdown skill.
- Supports converting PDF and image documents (JPEG, PNG, GIF, WebP, TIFF, BMP) to clean Markdown via the PDF2Markdown CLI.
- Handles both synchronous parsing (for files under ~30MB) and async parsing (for large files up to 100MB).
- Provides usage examples for direct file input and URL-based processing.
- Output is organized in a dedicated `.pdf2markdown/` directory; supports both Markdown and JSON formats.
- Requires pre-installation and authentication before use.
Metadata
Frequently Asked Questions
What is PDF to markdown converter?
Convert PDF and image documents to clean Markdown via the PDF2Markdown CLI. Use when the user wants to extract text from PDFs, convert PDFs to markdown, pars... It is an AI Agent Skill for Claude Code / OpenClaw, with 314 downloads so far.
How do I install PDF to markdown converter?
Run "/install pdf2markdown" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PDF to markdown converter free?
Yes, PDF to markdown converter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does PDF to markdown converter support?
PDF to markdown converter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PDF to markdown converter?
It is built and maintained by QThans (@qthans); the current version is v0.1.0.
More Skills