# Send Recite to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "recite",
    "name": "Recite",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/rivradev/recite",
    "canonicalUrl": "https://clawhub.ai/rivradev/recite",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/recite",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=recite",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "long_term_memory.md",
      "process_receipts.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "recite",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T08:58:00.170Z",
      "expiresAt": "2026-05-10T08:58:00.170Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=recite",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=recite",
        "contentDisposition": "attachment; filename=\"recite-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "recite"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/recite"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/recite",
    "downloadUrl": "https://openagent3.xyz/downloads/recite",
    "agentUrl": "https://openagent3.xyz/skills/recite/agent",
    "manifestUrl": "https://openagent3.xyz/skills/recite/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/recite/agent.md"
  }
}
```
## Documentation

### Recite 🦞🤵

AI-driven receipt bookkeeping via the Recite Vision API. Use recite-process to scan a directory of receipts and PDF files, rename them based on extracted data, and log transactions to a CSV file.

### 1. API Key

You can generate your Recite API key at: https://recite.rivra.dev/settings/api.

Set the API key in your environment or configuration file:

Environment: export RECITE_API_KEY="re_live_YOUR_API_KEY"
Config: Create ~/.config/recite/config.json with {"api_key": "re_live_..."}.

### 2. Dependencies

Ensure you have python3, requests, and csv installed.

### 1. Mandatory API Key Pre-check

Before performing any scanning, file manipulation, or bookkeeping tasks, the agent MUST verify if a valid Recite API key is available (via RECITE_API_KEY environment variable or ~/.config/recite/config.json).

If missing: Immediately stop all other operations and instruct the user to obtain an API key from https://recite.rivra.dev/settings/api and provide it. Do not attempt to list files or proceed with any part of the workflow until the key is confirmed.

### 3. Schema-Aware Bookkeeping

The agent is designed to handle API response changes gracefully:

Dynamic Schema Evolution: If the Recite API adds new information (new JSON fields), the agent will automatically add corresponding columns to your bookkeeping_transactions.CSV without losing existing data.
Data Integrity Protection: If a field that was previously present in the CSV is missing from the current API response, the agent will skip saving that specific entry and warn the user, preventing data corruption or "shifted" columns.

### Workflow & Features

Scan Folder: The agent scans the specified folder for images (.jpg, .jpeg, .png) and .pdf files.
AI Extraction: Calls the Recite API to extract date, vendor, total, currency, and category.
Smart Renaming: Renames the file to [date]_[vendor].[ext] (e.g., 2024-05-20_Starbucks.jpg).
Bookkeeping Log: Appends the extracted data (Date, Vendor, Total, Currency, Category, Subtotal, Tax, Tip, Fees, Discounts, Description, Payment Method, Confidence, etc.) and filenames to bookkeeping_transactions.CSV in the target folder.
Status Report: Provides a summary of processed files and the CSV location.

### Long-Term Memory & Custom Logic

Modify skills/recite/long_term_memory.md to add persistent instructions for the agent. The agent will always read this file before processing.

Examples:

"After processing, move all files to a sub-folder named processed/."
"Alert me if any single receipt is over $500."
"Always categorize 'Amazon' as 'Software Services'."

### Tool Usage

Command: python3 skills/recite/process_receipts.py <target_directory> skills/recite/
Arguments:

<target_directory>: The folder containing your receipts.
skills/recite/: The path to the skill folder (used to locate long_term_memory.md).

### Strategic Moat

Agent-First Consistency: Guaranteed structured JSON output for financial data.
Tax-Ready Logic: Intelligent categorization based on standard business practices.
Seamless Integration: Built for the AI Agent economy (OpenClaw, Claude Code).
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: rivradev
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T08:58:00.170Z
- Expires at: 2026-05-10T08:58:00.170Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/recite)
- [Send to Agent page](https://openagent3.xyz/skills/recite/agent)
- [JSON manifest](https://openagent3.xyz/skills/recite/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/recite/agent.md)
- [Download page](https://openagent3.xyz/downloads/recite)