Skip to content
Skills Library
Documents & office · Conversion & formats

extract-document-data

/extract-document-data

Extract structured, grounded fields from documents — values cite their page, missing values abstain instead of hallucinating. Use for parsing invoices, payslips, statements, contracts.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Extract structured, grounded fields from documents — values cite their page, missing values abstain instead of hallucinating. Use for parsing invoices, payslips, statements, contracts.

Original author description

Extract structured, grounded fields from documents — values cite their page, missing values abstain instead of hallucinating. Use for parsing invoices, payslips, statements, contracts.

How it works

  1. When to use
  2. Instructions
  3. Output format
  4. Limitations and Safety
  5. Notes
Original SKILL.md headings · 85 lines, 503 words
SKILL.md preview
---
name: extract-document-data
description: Extract structured, grounded fields from documents — values cite their page, missing values abstain instead of hallucinating. Use for parsing invoices, payslips, statements, contracts.
category: document-verification
risk: critical
source: community
source_repo: Sketchjar/stipple-agent-skills
source_type: community
date_added: "2026-08-31"
author: Sketchjar
tags: [document-verification, fact-checking, stipple, authenticity]
tools: [claude, cursor, gemini, codex]
license: "Apache-2.0"
license_source: "https://github.com/Sketchjar/stipple-agent-skills/blob/main/LICENSE"
---

# Extract Document Data

Extract structured JSON from documents with per-value grounding: every extracted value cites where it came from (page number, confidence), and values that aren't clearly present are reported in `not_found` rather than hallucinated. Uses the Stipple API (free anonymous tier).

## When to use

- Parsing payslips, invoices, bank statements, receipts, or contracts
- Converting unstructured documents to JSON for downstream systems
- Any extraction where hallucinated values are worse than missing values (lending, accounting, compliance)

## Instructions

1. **Get the document.** URL or local file path (PDF, PNG, JPEG, DOCX).

2. **Choose the extraction mode:**
   - **Ad-hoc fields** — tell the API exactly which fields you want:
     ```bash
     curl -X POST https://www.stipple.sh/v1/extract \
       -F "file=@payslip.pdf" \
       -F 'fields=[{"name":"employer_name"},{"name":"net_pay"},{"name":"pay_date"}]' \
       -H "Authorization: Bearer $STIPPLE_API_KEY"
     ```
   - **Template** — use a built-in schema: `payslip`, `tax_invoice`, `bank_statement`, `receipt`, `contract`
   - **Schema-free** — omit `fields` and let the model extract what it finds

3. **Interpret the response.**

   ```json
   {
     "mode": "schema_free",
     "document_type": "payslip",
     "pages_read": 1,
     "fields": {
       "employer_name": {"value": "Acme Cleaning Pty Ltd", "confidence": 0.95, "page": 1},
       "net_pay": {"value": "2845.10", "confidence": 0.97, "page": 1}
     },
     "not_found": ["ytd_tax"]
   }
   ```

   - Every value carries `confidence` (the model's self-report) and `page` (grounding)
   - `not_found[]` lists requested fields the model couldn't find — **absences are reported, never guessed**
   - `pages_read` shows how many pages were processed (page limits apply per document)

4. **Report honestly.** This is *extraction, not verification* — values are what the document **shows**, not proof it's genuine:
   - "Employer: Acme Cleaning Pty Ltd (confidence 0.95, page 1)"
   - "ytd_tax: not found in document" — never "ytd_tax: 0" or a guess
   - For "is this document genuine?", pair with the `verify-document` skill first

## Output format

```
Payslip fields (grounded, not guessed):

  Employer          Acme Cleaning Pty Ltd  (confidence 0.95, page 1)
  Employee          J. Citizen             (confidence 0.98, page 1)
  Net pay           2,845.10               (confidence 0.97, page 1)
  Superannuation    268.20                 (confidence 0.93, page 1)

not_found: ytd_tax
(absences are reported, never hallucinated)
```

## Limitations and Safety

- Invoices, statements, payslips, and contracts often contain sensitive personal,
  financial, or commercial data. Obtain explicit approval before uploading them to
  a hosted third party, minimize the submitted content, and confirm current
  retention, residency, access, and deletion terms.
- Confidence and page grounding do not prove that an extracted value is correct or
  that the source document is authentic. Reconcile consequential values against the
  original document and authoritative systems before payment, lending, accounting,
  compliance, or legal action.
- Keep the original file and extraction response so a human reviewer can reproduce
  and correct disputed fields.

## Notes

- Costs 1 credit per page read by the model (minimum 1); free weekly allowance applies
- Templates: `payslip`, `tax_invoice`, `bank_statement`, `receipt`, `contract` — pass as the `template` form field
- Tables are extracted with structure preserved; multi-page documents are processed page by page
- Pairs with `verify-document` (run first, for authenticity) — an extracted value from a tampered document is still wrong
- Free key at https://www.stipple.sh for metering beyond the anonymous allowance

Versions

The database has no other skills named extract-document-data.

Identical content appears in 3 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version c101880b2f4e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100data-extractor
    Extract structured data from any document format using unified document processing. Use when a user asks to extract data from a document, parse a PDF, pull structured data from files, convert documents to JSON or CSV, extract fields from invoices or forms, or scrape data from documents.
  • 90veryfi-documents-ai
    Real-time OCR and data extraction API by Veryfi (https://veryfi.com). Extract structured data from receipts, invoices, bank statements, W-9s, purchase orders, bills of lading, and any other document. Use when you need to OCR documents, extract fields, parse receipts/invoices,…
  • 84pdf-extractor
    Design AI extraction configurations for structured and semi-structured insurance and mortgage PDFs. Use when configuring a document AI model to extract data fields from applications, policy documents, EOBs, pay stubs, tax returns, or bank statements.
  • 100document-understanding
    Reads fields and tables out of documents (invoices, receipts, purchase orders, statements, IDs, payslips, forms, any PDF or scan) with a Document Understanding reader, by conversation with a non-technical person: set up or reuse a reader, confirm its fields in plain words, try…
  • 100reducto-document-parsing
    This skill should be used when the user asks to "parse a document", "extract data from PDF", "process invoices", "convert PDF to markdown", "extract structured data", "edit a document", mentions "reducto", or discusses document processing, OCR, PDF parsing, invoice extraction,…
  • 100processing-pdf
    Use when the user needs to extract data from PDFs, work with scanned documents, or manipulate PDF files. Triggers include: "extract text from PDF", "convert PDF to text/CSV/images", "scan/OCR this document", "merge/split/rotate PDF", "fill PDF form", "PDF is blank/empty" (likely…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.