ClawHub

Bid Reader

v1.0.0

Extracts and returns plain text from PDF, Word (.docx), and Excel (.xlsx/.xls) bid documents for analysis, search, or summarisation.

⭐ 0· 64·0 current·0 all-time
by@ezhencacao-dotcom

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for ezhencacao-dotcom/bid-reader.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Bid Reader" (ezhencacao-dotcom/bid-reader) from ClawHub.
Skill page: https://clawhub.ai/ezhencacao-dotcom/bid-reader
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install bid-reader

ClawHub CLI

Package manager switcher

npx clawhub@latest install bid-reader
Security Scan
VirusTotalVirusTotal
Pending
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description match the code and requirements: pdfplumber, python-docx, pandas/openpyxl are appropriate for extracting text from PDF, .docx and Excel files. Minor mismatch: SKILL.md advertises a 'bid-read' command but no wrapper is provided in the bundle (you'd need to invoke scripts/read.py or create an executable entrypoint). The code also accepts '.doc' extension but uses python-docx (which only supports .docx), so '.doc' handling is likely to fail — a correctness issue, not a security one.
✓
Instruction Scope
SKILL.md instructs the agent to read a workspace or absolute file path and print extracted text to stdout. The implementation only reads the provided file and does not access other files, network endpoints, or environment variables. There is no broad or vague instruction to gather extra context or scan unrelated paths.
ℹ
Install Mechanism
No packaged install spec is provided (instruction-only plus a local script). Installation relies on pip installing requirements.txt from PyPI, which is normal for a Python utility but will fetch third-party packages over the network; consider installing in a virtual environment. Nothing in the install steps pulls code from arbitrary URLs or personal servers.
✓
Credentials
The skill declares no required environment variables, credentials, or config paths and the code does not read any env vars. Requested permissions are minimal and proportional to the task.
✓
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent presence or modify other skills or system-wide settings. Autonomous invocation is allowed by default but the skill's operations are limited to local file reading when invoked.
Assessment
This skill appears internally consistent and limited to extracting text from files. Before installing: (1) install the Python deps in an isolated virtual environment to avoid polluting your system/site packages, (2) be aware the script will read any file path you pass it — do not point it at sensitive files you don't want processed, (3) the repo does not provide a 'bid-read' executable wrapper; run the script directly (python scripts/read.py /path/to/file) or add your own launcher, and (4) note that .doc support is advertised but likely unsupported by python-docx (use .docx). If you need OCR for scanned PDFs or stricter sandboxing, add those safeguards before using on untrusted documents.

Like a lobster shell, security has layers — review code before you run it.

latestvk979n93j4bx07zaqay1fem8ewh853fvr
64downloads
0stars
1versions
Updated 1w ago
v1.0.0
MIT-0
@ezhencacao-dotcom
latest
Download

bid-reader Skill

Overview

A lightweight skill to extract readable text from bid and tender documents in PDF, Word (.docx), and Excel (.xlsx/.xls) formats. It can be invoked from the OpenClaw UI or other agents to quickly pull the full textual content of a file for analysis, search, or summarisation.

Usage

bid-read <file-path>
  • <file-path> should be an absolute or workspace‑relative path to a document.
  • The skill prints the extracted plain‑text to stdout, which OpenClaw captures and returns to the caller.

Example

bid-read /home/zhenxing/投标文件/招投标项目1/13.上海联通/投标文件.pdf

The command returns the full text of the PDF, ready for further processing (e.g., keyword search, summarisation).

Installation

Copy the skill folder into your workspace under skills/bid-reader. Install required Python packages:

pip install -r $(pwd)/skills/bid-reader/requirements.txt

The skill is then available as an agent command.

Implementation Details

  • PDF: Uses pdfplumber to extract text page‑by‑page.
  • Word: Uses python-docx to read paragraphs.
  • Excel: Uses pandas (with openpyxl/xlrd) to read all sheets and concatenate cell values.

Limitations

  • Only .pdf, .docx, .xlsx, and .xls are supported. Other formats will be ignored.
  • Large files may take a few seconds to process.
  • Tables are flattened into whitespace‑separated rows; complex formatting is not preserved.

Future Enhancements

  • Add OCR fallback for scanned PDFs (e.g., via pytesseract).
  • Support selective page or sheet extraction.
  • Provide a JSON output mode with structural metadata.

Comments

Loading comments...