# Scan Receipts Into Expense Records

Receipt processing often needs OCR checks, category review, and database validation. This skill guides receipt parsing, troubleshooting, and expense record workflows.

## Install

```bash
npx skillstore add egadams/receipt-scanner-master
```

## Metadata

- Status: approved
- Slug: egadams-receipt-scanner-master
- Skillstore revision: r1
- Version status: missing
- Tree hash: f4b99acacddd382ddf3708b933b04d2190a959b869163fdd374537ca6e86fcc4
- Author: EGAdams
- GitHub username: EGAdams
- License: MIT
- Repository: https://github.com/EGAdams/planner/tree/main/nonprofit\_finance\_db/.claude/skills/receipt-scanner
- Ref: 72d5025b022c77f7a51bdf5c1637c689c80e89d1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, env\_access
- Quality score: 77
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/egadams-receipt-scanner-master
- Manifest: https://skillstore.pages.dev/api/skills/egadams-receipt-scanner-master/manifest

## Capabilities

- Explains the receipt upload and parsing workflow for images, PDFs, and WebP files.
- Guides validation of merchant details, line items, totals, taxes, and payment methods.
- Documents category selection behavior and database save rules for receipt items.
- Provides troubleshooting steps for OCR errors, upload failures, and timeout issues.
- Identifies related backend, frontend, configuration, and test files for maintenance.

## Use Cases

- Review Scanned Receipts: Validate extracted merchant data, line items, categories, and totals before saving expenses.
- Debug OCR Problems: Investigate incorrect prices, missing items, unclear images, and model quota errors.
- Improve Receipt Workflows: Update prompts, validation checks, image processing, and database integration for receipt handling.

## Prompt Templates

### Scan One Receipt

```
Help me scan this receipt and explain which fields I should verify before saving it.
```

### Check OCR Accuracy

```
Compare the parsed receipt data with the source image and list any likely OCR mistakes.
```

### Troubleshoot Saving

```
The receipt parsed correctly, but items did not save. Trace the category and database workflow.
```

### Enhance Receipt Parsing

```
Review the receipt parser and prompt rules, then propose changes to improve item extraction accuracy.
```

## Limitations

- Requires the local receipt scanner application and API routes described by the skill.
- Does not provide an OCR model or receipt database by itself.
- Accuracy depends on image quality and the configured Gemini model.
- Examples use local development paths that may need adjustment.

## Best Practices

- Use clear, well-lit receipt images before debugging OCR behavior.
- Validate totals and line items before saving categorized expenses.
- Keep problematic receipts as regression samples for parser changes.

## Anti Patterns

- Do not save parsed receipt data without reviewing categories and totals.
- Do not treat uncategorized items as saved expense records.
- Do not paste real API keys into shared prompts or logs.

## Security Audit

- Audited at: 2026-07-06T11:50:04.912\+00:00
- Summary: The static findings are false positives caused by Markdown formatting, localhost examples, placeholder API key setup, and normal receipt database checks. No evidence of prompt injection, secret exfiltration, malicious network activity, or executable backtick evaluation was found.

## Stats

- Views: 318
- Downloads: 9
- Favorites: 0
- Popularity score: 0