{ "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": { "downloadMode": "redirect", "downloadUrl": "/downloads/recite", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=recite", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "long_term_memory.md", "process_receipts.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/recite", "agentPageUrl": "https://openagent3.xyz/skills/recite/agent", "manifestUrl": "https://openagent3.xyz/skills/recite/agent.json", "briefUrl": "https://openagent3.xyz/skills/recite/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Recite 🦞🀡", "body": "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." }, { "title": "1. API Key", "body": "You can generate your Recite API key at: https://recite.rivra.dev/settings/api.\n\nSet the API key in your environment or configuration file:\n\nEnvironment: export RECITE_API_KEY=\"re_live_YOUR_API_KEY\"\nConfig: Create ~/.config/recite/config.json with {\"api_key\": \"re_live_...\"}." }, { "title": "2. Dependencies", "body": "Ensure you have python3, requests, and csv installed." }, { "title": "1. Mandatory API Key Pre-check", "body": "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).\n\nIf 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." }, { "title": "3. Schema-Aware Bookkeeping", "body": "The agent is designed to handle API response changes gracefully:\n\nDynamic 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.\nData 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." }, { "title": "Workflow & Features", "body": "Scan Folder: The agent scans the specified folder for images (.jpg, .jpeg, .png) and .pdf files.\nAI Extraction: Calls the Recite API to extract date, vendor, total, currency, and category.\nSmart Renaming: Renames the file to [date]_[vendor].[ext] (e.g., 2024-05-20_Starbucks.jpg).\nBookkeeping 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.\nStatus Report: Provides a summary of processed files and the CSV location." }, { "title": "Long-Term Memory & Custom Logic", "body": "Modify skills/recite/long_term_memory.md to add persistent instructions for the agent. The agent will always read this file before processing.\n\nExamples:\n\n\"After processing, move all files to a sub-folder named processed/.\"\n\"Alert me if any single receipt is over $500.\"\n\"Always categorize 'Amazon' as 'Software Services'.\"" }, { "title": "Tool Usage", "body": "Command: python3 skills/recite/process_receipts.py skills/recite/\nArguments:\n\n: The folder containing your receipts.\nskills/recite/: The path to the skill folder (used to locate long_term_memory.md)." }, { "title": "Strategic Moat", "body": "Agent-First Consistency: Guaranteed structured JSON output for financial data.\nTax-Ready Logic: Intelligent categorization based on standard business practices.\nSeamless Integration: Built for the AI Agent economy (OpenClaw, Claude Code)." } ], "body": "name: recite description: AI receipt scanner & bookkeeping automation. Process receipts, invoices, and PDFs. Extracts data to rename files and log transactions/expenses to CSV. Perfect for tax & accounting.\nRecite 🦞🀡\n\nAI-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.\n\nSetup & Configuration\n1. API Key\n\nYou can generate your Recite API key at: https://recite.rivra.dev/settings/api.\n\nSet the API key in your environment or configuration file:\n\nEnvironment: export RECITE_API_KEY=\"re_live_YOUR_API_KEY\"\nConfig: Create ~/.config/recite/config.json with {\"api_key\": \"re_live_...\"}.\n2. Dependencies\n\nEnsure you have python3, requests, and csv installed.\n\nOperational Rules\n1. Mandatory API Key Pre-check\n\nBefore 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).\n\nIf 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.\n3. Schema-Aware Bookkeeping\n\nThe agent is designed to handle API response changes gracefully:\n\nDynamic 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.\nData 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.\nWorkflow & Features\nScan Folder: The agent scans the specified folder for images (.jpg, .jpeg, .png) and .pdf files.\nAI Extraction: Calls the Recite API to extract date, vendor, total, currency, and category.\nSmart Renaming: Renames the file to [date]_[vendor].[ext] (e.g., 2024-05-20_Starbucks.jpg).\nBookkeeping 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.\nStatus Report: Provides a summary of processed files and the CSV location.\nLong-Term Memory & Custom Logic\n\nModify skills/recite/long_term_memory.md to add persistent instructions for the agent. The agent will always read this file before processing.\n\nExamples:\n\n\"After processing, move all files to a sub-folder named processed/.\"\n\"Alert me if any single receipt is over $500.\"\n\"Always categorize 'Amazon' as 'Software Services'.\"\nTool Usage\nCommand: python3 skills/recite/process_receipts.py skills/recite/\nArguments:\n: The folder containing your receipts.\nskills/recite/: The path to the skill folder (used to locate long_term_memory.md).\nStrategic Moat\nAgent-First Consistency: Guaranteed structured JSON output for financial data.\nTax-Ready Logic: Intelligent categorization based on standard business practices.\nSeamless Integration: Built for the AI Agent economy (OpenClaw, Claude Code)." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/rivradev/recite", "publisherUrl": "https://clawhub.ai/rivradev/recite", "owner": "rivradev", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "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" } }