← Back to Skills Marketplace
97
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install invoice-processing
Description
Process and organize invoice PDFs by fixing extensions, removing duplicates and invalid files, checking for keywords, and calculating total amounts.
README (SKILL.md)
WORKFLOW SKILL — Process and organize invoice PDFs using main.py.
USE FOR: Organizing invoices in a directory when the user provides a keyword. Capabilities include:
- Fixing
.pdfextensions (files ending in?or？). - Removing duplicate files based on MD5 hash.
- Removing invalid files (e.g. containing "行程单").
- Checking PDF contents for a mandatory missing
keyword. - Calculating the grand total amount from all valid invoices.
DO NOT USE FOR: General Python debugging or other non-invoice related tasks.
INVOKES: Terminal tool to run python main.py process \x3Ckeyword> -d \x3Cdir>
Instructions for the Agent
When the user asks you to process or organize invoices (e.g., "整理 ./fapiao 里 的发票，关键字是 银河科技;腾讯"):
- Extract Arguments:
dir: The target directory. If the user does not specify a directory, safely default to the current directory (.) or ask the user if it is ambiguous.keyword: The target keyword to check inside the PDFs (e.g., a company name). Note: Multiple keywords can be provided separated by a semicolon;(e.g.,CompanyA;CompanyB).
- Handle Missing Keyword:
- You MUST prompt the user for the
\x3Ckeyword>if it is missing from their request. Do not guess it.
- You MUST prompt the user for the
- Execute Command:
- Construct and run the following terminal command (replacing placeholders with extracted values):
python main.py process \x3Ckeyword> -d \x3Cdir>
- Construct and run the following terminal command (replacing placeholders with extracted values):
- Report Results:
- After the script completes, summarize the printed results for the user (files fixed, dupes removed, files moved to
\x3Cdir>/invoices, and files moved to\x3Cdir>/invoices/unknown, plus the grand total).
- After the script completes, summarize the printed results for the user (files fixed, dupes removed, files moved to
Usage Guidance
This skill appears to do what it says: it scans PDFs, renames files, removes duplicates, deletes files whose names contain '行程单', moves matched/unknown invoices into invoices/ subfolders, and computes a total. There is no network communication or secret access. However, it performs destructive actions (deleting files and moving others) without prompting for confirmation. Before running: 1) back up the directory or test on a copy; 2) ensure PyMuPDF is installed (pip install PyMuPDF); 3) provide the correct keyword(s) — the script requires a keyword argument and will not guess it; and 4) review sample outputs first (run on a small set) to confirm it behaves as you expect. If you need non-destructive behavior, ask the developer to add a dry-run / confirmation flag or to prompt before deleting files.
Capability Analysis
Type: OpenClaw Skill
Name: invoice-processing
Version: 1.0.0
The skill bundle is a legitimate utility for organizing invoice PDFs. It performs file operations such as renaming extensions, removing duplicates via MD5 hashing, filtering files by content keywords using PyMuPDF (fitz), and calculating totals via regex. All actions are consistent with the stated purpose in SKILL.md and main.py, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (fix extensions, dedupe, remove invalids, check keywords, sum amounts) align with the included main.py implementation. The code implements exactly those behaviors (extension rename, MD5 dedupe, remove files with '行程单' in the filename, keyword-based PDF content checks, moving files into invoices/ and invoices/unknown/, and totaling amounts). No unrelated capabilities (network access, unrelated cloud credentials) are present.
Instruction Scope
SKILL.md instructs the agent to run 'python main.py process <keyword> -d <dir>' and to prompt for a missing keyword — that matches main.py's required args. However the runtime behavior is destructive: duplicates are deleted (os.remove) and files with a filename keyword are deleted; other PDFs are moved into invoices/ and invoices/unknown/. SKILL.md does not require explicit user confirmation or suggest creating backups before running, which increases the chance of accidental data loss.
Install Mechanism
There is no install spec (instruction-only install). requirements.txt lists PyMuPDF, and main.py imports fitz (PyMuPDF). The agent or user must ensure PyMuPDF is installed; no code is downloaded at install time and there are no external network calls in the code. This is low install risk but the dependency must be satisfied before running.
Credentials
The skill declares no environment variables, requires no credentials, and main.py does not read environment variables or external config. Requested access is limited to the target directory provided by the user, which is appropriate for this purpose.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or global agent settings. It operates only on the user-specified filesystem directory. No elevated or persistent privileges are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install invoice-processing - After installation, invoke the skill by name or use
/invoice-processing - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the invoice-processing workflow skill.
- Organizes invoice PDFs in a specified directory based on a user-provided keyword.
- Fixes PDF files with incorrect extensions, removes duplicates and invalid files.
- Checks invoices for a mandatory content keyword; supports multiple keywords separated by semicolons.
- Calculates and reports grand total amount from validated invoices.
- Prompts for required keyword if missing and summarizes results after processing.
Metadata
Frequently Asked Questions
What is FapiaoClaw?
Process and organize invoice PDFs by fixing extensions, removing duplicates and invalid files, checking for keywords, and calculating total amounts. It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install FapiaoClaw?
Run "/install invoice-processing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is FapiaoClaw free?
Yes, FapiaoClaw is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does FapiaoClaw support?
FapiaoClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created FapiaoClaw?
It is built and maintained by JOE (@jie); the current version is v1.0.0.
More Skills