← Back to Skills Marketplace
Skill PDF Orgnizer
by
Yiming Liu
· GitHub ↗
· v1.0.0
· MIT-0
146
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skill-pdf-orgnizer
Description
Organizes PDFs by extracting metadata and classifying into topics, renaming files, and sorting into topic-based folders using AI analysis.
Usage Guidance
This skill appears to do what it says: it reads PDFs locally, sends excerpts to OpenAI or the Kimi API for analysis, then creates folders and moves/renames files. Before running: (1) Be aware that document content (up to the configured max_chars) will be transmitted to a third‑party API—do not use on sensitive or confidential PDFs unless you accept that exposure. (2) The API key is stored in config.json; keep that file secure and do not commit it to version control. (3) Run in dry_run mode first to preview changes and ensure naming/foldering meets your expectations. (4) Back up your PDFs (or run on a copy) before allowing actual moves. (5) Note the Kimi provider uses https://api.moonshot.cn as the base URL—confirm you trust that provider if you choose it. If you want additional assurance, you can audit the code locally (it’s included) and run the tool in a sandbox or with a small sample set first.
Capability Analysis
Type: OpenClaw Skill
Name: skill-pdf-orgnizer
Version: 1.0.0
The PDF Organizer skill is a well-structured tool designed to categorize and rename PDF files using LLM analysis (OpenAI or Kimi). The code uses standard libraries like PyPDF2 for text extraction and shutil for file operations, with no evidence of malicious intent, data exfiltration, or unauthorized command execution across files like pdf_organizer.py and content_analyzer.py.
Capability Assessment
Purpose & Capability
Name/description (organize PDFs using AI) match the code and runtime needs: reading PDFs, calling an LLM API to extract metadata and classify topics, creating folders, and moving/renaming files. The skill requires an API key (stored in config.json) which is appropriate for the stated OpenAI/Kimi integration.
Instruction Scope
The SKILL.md and code are consistent: the skill reads PDF content (up to max_chars) and sends it to OpenAI or the Kimi endpoint for analysis. This is expected for an AI classification tool, but it does transmit potentially sensitive document content to external APIs (OpenAI or https://api.moonshot.cn for Kimi). The skill also creates cache files (.folder_cache.json, .processed_files.json) and will move/rename original PDFs (unless dry_run=true).
Install Mechanism
No install script in the registry entry (instruction-only), but the bundle includes requirements.txt and setup.py. Dependencies are standard (PyPDF2, openai, python-dotenv). There is no remote download of arbitrary code or use of obscure URLs; installing requires running pip install -r requirements.txt (low risk).
Credentials
The only credential required is an API key (openai_api_key) stored in config.json, which matches the use of OpenAI/Kimi APIs. No unrelated environment variables, system credentials, or platform tokens are requested. python-dotenv is listed but not used—minor mismatch but not a credential risk in itself.
Persistence & Privilege
The skill does not request always:true, does not alter other skills, and only writes application-scoped files (cache and processed logs) plus move/rename operations in user folders. These behaviors are expected for a file-organization tool; moving files is destructive if misconfigured, so dry-run and backups are important.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-pdf-orgnizer - After installation, invoke the skill by name or use
/skill-pdf-orgnizer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
PDF Organizer Skill 1.0.0 – Initial Release
- Automatically categorizes and organizes PDFs by topic using GPT analysis.
- Extracts key metadata (title, author, journal) for smart file naming.
- Creates topic and subtopic folder structure for organized storage.
- Supports batch and incremental processing of multiple PDF files.
- Handles corrupted files and API failures gracefully, with detailed logging.
- Fully configurable through a simple JSON file.
Metadata
Frequently Asked Questions
What is Skill PDF Orgnizer?
Organizes PDFs by extracting metadata and classifying into topics, renaming files, and sorting into topic-based folders using AI analysis. It is an AI Agent Skill for Claude Code / OpenClaw, with 146 downloads so far.
How do I install Skill PDF Orgnizer?
Run "/install skill-pdf-orgnizer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill PDF Orgnizer free?
Yes, Skill PDF Orgnizer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skill PDF Orgnizer support?
Skill PDF Orgnizer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill PDF Orgnizer?
It is built and maintained by Yiming Liu (@yxl184); the current version is v1.0.0.
More Skills