← Back to Skills Marketplace
nollio

DocuScan

by Nollio · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
123
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install normieclaw-docuscan
Description
Forget clunky scanner apps with watermarks and $10/month subscriptions. DocuScan lets you snap a photo of any receipt, contract, whiteboard, or handwritten n...
Usage Guidance
DocuScan appears to be what it claims: a local-first document OCR → markdown → PDF tool. Before installing or using it, do the following: - Manually install and verify prerequisites: ensure python3 is available and run 'pip install playwright' and 'playwright install chromium' yourself; the registry metadata does not declare these dependencies. Review the Playwright download step since it fetches a browser binary. - Review the two scripts (generate-pdf.py and generate-pdf.sh) — they explicitly disable JavaScript and block non-local requests in Playwright, which reduces exfiltration risk during PDF rendering. Keep those protections in place and avoid enabling JavaScript there. - Create the documents/ directory with strict permissions (chmod 700) and review any autogenerated filenames before opening them. The skill provides filename-sanitization rules, but verify they are enforced in your runtime. - Test with non-sensitive sample documents first to confirm behavior and that files stay local. - Only enable/use the Dashboard Companion Kit if you understand and securely supply any external DB/service credentials (the dashboard requires Supabase or similar and will need environment variables); follow the dashboard's security guidance (RLS, encryption at rest, private storage buckets). - Despite explicit prompt-injection defenses, be cautious: scanned documents can themselves contain adversarial text. The skill correctly warns to never treat scanned text as executable instructions — keep that policy enforced in your agent configuration. If you want higher assurance, run the skill in a restricted environment (isolated user account or container), verify file writes are constrained to the documents/ folder, and review any changes to your environment before trusting it with highly sensitive documents.
Capability Analysis
Type: OpenClaw Skill Name: normieclaw-docuscan Version: 1.0.3 The DocuScan skill is a well-documented and security-conscious tool for converting images to PDFs. It implements multiple layers of defense against common AI agent risks, including explicit instructions in SKILL.md to treat scanned text as data rather than commands (prompt injection defense) and robust path validation in generate-pdf.py to prevent path traversal. Furthermore, the PDF generation script explicitly disables JavaScript and blocks all non-local network requests via Playwright to prevent data exfiltration or SSRF during the rendering process.
Capability Assessment
Purpose & Capability
The skill's name, README, SKILL.md and scripts all align with a scanner/OCR → markdown → PDF workflow. The included Python and shell scripts implement PDF generation via Playwright, which is expected for the described feature set. Minor inconsistency: registry metadata lists no required binaries or env vars, but the README and scripts require Python 3 and Playwright (and Playwright will download Chromium). This missing dependency declaration is a usability/security note but does not indicate malicious intent.
Instruction Scope
SKILL.md stays within the document-scanning scope: it explains OCR/reconstruction rules, filename sanitization, where to store outputs (documents/), combining pages, and calls the local generate-pdf.sh/py scripts to produce PDFs. It explicitly warns about prompt injection and instructs the agent to treat extracted text only as data. There are no instructions to read unrelated system files or send data to external endpoints.
Install Mechanism
There is no registry install spec (instruction-only), so nothing will be automatically downloaded by the skill itself. However, the included scripts require Playwright and Python; the README instructs the user to run 'pip install playwright' and 'playwright install chromium', which will download a browser binary. The generate-pdf.py script explicitly disables JavaScript and blocks non-local requests in Playwright, which mitigates network-exfiltration risk during rendering.
Credentials
The skill declares no required environment variables or credentials, matching the local-only processing claims. The optional Dashboard Companion Kit references Supabase and environment variables for deployment, but those are optional; they are documented as requiring secure handling. No unexpected secret-exfiltration vectors are present in the core skill files.
Persistence & Privilege
The skill does not request always:true and is user-invocable only by default. Its setup prompt asks to create a local documents/ directory and a scan-log.json file — normal for local-first tools. The skill does not modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install normieclaw-docuscan
  3. After installation, invoke the skill by name or use /normieclaw-docuscan
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
v1.0.3: Security fixes: confined scripts to skill directory, removed filesystem traversal from setup
v1.0.2
v1.0.2: MIT license, cleaned descriptions, removed cross-sell
v1.0.0
Initial publish from NormieClaw.ai — Free OpenClaw skills for everyone.
Metadata
Slug normieclaw-docuscan
Version 1.0.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is DocuScan?

Forget clunky scanner apps with watermarks and $10/month subscriptions. DocuScan lets you snap a photo of any receipt, contract, whiteboard, or handwritten n... It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.

How do I install DocuScan?

Run "/install normieclaw-docuscan" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is DocuScan free?

Yes, DocuScan is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does DocuScan support?

DocuScan is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created DocuScan?

It is built and maintained by Nollio (@nollio); the current version is v1.0.3.

💬 Comments