An AI-driven automation tool that analyzes PDF content to intelligently categorize files into folders and apply standardized naming conventions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pdf-organizer-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pdf-organizer-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PDF Organizer Skill?
The PDF Organizer Skill is a sophisticated automation utility designed to eliminate the manual labor of managing large document libraries. By leveraging advanced LLMs like OpenAI and Kimi, this skill deep-scans PDF text to identify key metadata including titles, authors, and publication journals. It represents a significant advancement in document management within the Openclaw Skills framework, ensuring your digital workspace remains structured and searchable without manual intervention.
The tool goes beyond simple file moving; it understands context. It interprets the subject matter of each document to place it within a hierarchical folder structure based on ten standard categories such as Technology, Finance, and Science. This intelligent classification makes it an essential asset for researchers, students, and professionals dealing with high-volume document workflows.
PDF Organizer Skill Use Cases
- Automatically organizing academic research papers by field and author.
- Streamlining corporate archives by categorizing financial reports and business whitepapers.
- Standardizing messy download folders with uniform naming conventions.
- Preparing large datasets of PDF documents for easier search and retrieval.
How PDF Organizer Skill Works
- The skill scans the designated input folder for any new or modified PDF files.
- It extracts a specific character count from the beginning of the PDF to capture relevant metadata.
- The text is sent to a configured LLM (OpenAI or Kimi) to determine the topic, subtopic, title, and author.
- Based on the AI analysis, the skill creates a hierarchical folder structure (Topic/Subtopic) if it doesn't already exist.
- The file is renamed using a strict Title_Author_Journal.pdf format and moved to its final destination.
- Statistics and operations are logged for a final summary of the batch process.
PDF Organizer Skill Setup
To get started with this skill, ensure you have Python 3.8+ installed and follow these steps:
# Clone the repository and install dependencies
pip install -r requirements.txt
# Configure your API credentials
# Edit config.json with your openai_api_key or kimi_api_key
# Run the organization script
python pdf_organizer.py
PDF Organizer Skill Data Schema & Taxonomy
The skill organizes data into a structured hierarchy and applies a sanitized naming schema to all processed files:
| Level | Description |
|---|---|
| Root Folder | The defined output_folder (e.g., organized_pdfs/) |
| Category | High-level folders (e.g., Technology, Health, Finance) |
| Subtopic | Specific sub-folders based on AI classification |
| File Name | Standardized as Title_Author_Journal.pdf using underscores |
All metadata is derived dynamically during the analysis phase to ensure high accuracy.
PDF Organizer Skill Advanced Features
- Incremental Processing: Only analyzes new or modified files to save on API costs and time.
- Dry Run Mode: Preview the organization results and naming changes without performing any file operations.
- Custom Topic Mapping: Define specific categories via configuration to match niche industry requirements.
- Multi-Provider Support: Seamlessly switch between OpenAI and Kimi (Moonshot) APIs based on preference or availability.
- Robust Error Handling: Automatic management of corrupted PDFs and graceful recovery from API timeouts.
SKILL.md
Loading
Related Openclaw Skills
AI Meeting Minutes Assistant
An intelligent tool that transforms meeting audio recordings into structured minutes, including topics, decisions, and action items.
Affiliate Marketing Strategy
A comprehensive framework for planning and scaling affiliate marketing programs using cost-per-sale models to drive high-ROI growth.
Action Guard
Action Guard is a universal deduplication layer that prevents AI agents from repeating irreversible external actions like social media replies or token transfers.
AI Deep Research Agent
An advanced AI research assistant that generates comprehensive reports with citations and saves them to a persistent knowledge board.
Paid Skill Demo Template
A reference implementation for developers to build, protect, and monetize premium AI agent functionalities with license verification.
PRD to DDD Design Transformer
An automated workflow to convert PRDs into AI-ready Domain-Driven Design (DDD) documentation.
Featured*
