tres-report-analyzer — скилл для Claude Code
Скилл tres-report-analyzer для Claude Code читает XLSX-выгрузки TRES Finance и выдаёт сводку находок: аномалии, ключевые метрики, пункты для разбора.
MIT ★ 4 931 обновлён 2026-10-24
/plugin marketplace add anthropics/claude-plugins-community
/plugin install tres-finance-plugin@claude-communityЧто делает tres-report-analyzer
Скилл определяет тип отчёта по именам вкладок и заголовкам колонок — поддерживается больше пятнадцати форматов TRES Finance: Ledger Reconciliation, Asset Balances, Realized Gains & Losses, Cost Basis Stack, ERP Pre-Sync и другие. Если вкладки не совпадают ни с одним известным шаблоном, агент спрашивает, какой именно отчёт перед ним.
Для извлечения данных запускается скрипт scripts/analyze_report.py; если он не справляется с конкретным форматом, скилл читает файл через openpyxl напрямую. Логика проверки зависит от типа отчёта: в сверочных отчётах считаются провальные чеки и суммируются расхождения по активам и кошелькам, в балансовых — отслеживаются нулевые и отрицательные строки, в транзакционных — выделяются крупнейшие движения и неклассифицированные записи, в ERP-отчётах — незаполненные маппинги счетов и ошибки синхронизации.
Ответ строится по убыванию важности: сначала красные флаги, потом ключевые цифры, затем примечательные позиции и список конкретных действий. Числа округляются до читаемых значений, ответ держится в пределах 500 слов, если не попросить подробнее. Для работы нужен Python с установленным openpyxl.
Какие задачи решает
- определить тип TRES-отчёта по структуре XLSX без ручного разбора
- найти провальные чеки сверки и подсчитать суммарное расхождение
- выявить нулевые и отрицательные балансы в выгрузке активов
- сравнить движения лотов и отметить кандидатов на tax-loss harvesting
- проверить статус маппинга счетов перед синхронизацией с ERP
Примеры запросов агенту
- Загрузи
ledger_reconciliation_q1.xlsxи покажи, где расхождения - Проверь этот файл TRES на реализованные убытки по BTC за год
- Пройдись по отчёту ERP Pre-Sync и скажи, какие счета не настроены
Как установить tres-report-analyzer
1Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install tres-finance-plugin@claude-communityКоманда ставит плагин tres-finance-plugin целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add anthropics/claude-plugins-community --skill tres-report-analyzer -a claude-code3Вручную: положить файлы
~/.claude/skills/tres-report-analyzer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tres-report-analyzer/
1Через Skills CLI (Vercel)
npx skills add anthropics/claude-plugins-community --skill tres-report-analyzer -a codex2Вручную: положить файлы
.agents/skills/tres-report-analyzer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add anthropics/claude-plugins-community --skill tres-report-analyzer -a cursor2Вручную: положить файлы
.cursor/skills/tres-report-analyzer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install anthropics/claude-plugins-community tres-finance-plugin/skills/tres-report-analyzer2Вручную: положить файлы
.github/skills/tres-report-analyzer/SKILL.md1Через Skills CLI (Vercel)
npx skills add anthropics/claude-plugins-community --skill tres-report-analyzer -a gemini-cli2Командой платформы
gemini skills install https://github.com/anthropics/claude-plugins-community --path tres-finance-plugin/skills/tres-report-analyzerВручную: положить файлы
.devin/skills/tres-report-analyzer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tres-report-analyzer
Как установить tres-report-analyzer в Claude Code?
Выполните две команды: сначала /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install tres-finance-plugin@claude-community. После этого скилл доступен в Claude Code.
Что делает скилл tres-report-analyzer?
Он читает XLSX-файлы из TRES Finance, определяет тип отчёта по структуре вкладок и запускает соответствующие проверки. На выходе — сводка с аномалиями, ключевыми метриками и пунктами для дальнейшего разбора.
Нужен ли Python для работы скилла?
Да, скилл запускает scripts/analyze_report.py и использует библиотеку openpyxl. Если скрипт не отрабатывает, скилл читает файл через openpyxl напрямую, но сам Python должен быть установлен в окружении.
Исходный текст
SKILL.md · MIT
--- name: tres-report-analyzer description: Analyze any TRES Finance report XLSX and produce an automatic findings summary. Trigger this skill whenever a user uploads a .xlsx file that came from TRES Finance and asks to "analyze", "summarize", "review", "check", "audit", "look at", "what does this show", "any issues", "anything interesting", or "walk me through" the report. Also trigger when the user uploads an Excel file and mentions TRES, reconciliation, balances, transactions, cost basis, roll forward, or ERP sync. The skill identifies the report type from the file structure, runs targeted analysis based on report-specific logic, and produces a clear findings summary highlighting anomalies, key metrics, and action items. --- # TRES Report Analyzer You analyze TRES Finance report exports (XLSX files) and produce clear, actionable findings summaries. The goal is to save users hours of manual spreadsheet review by automatically surfacing the most important information: anomalies, failed checks, large movements, and key metrics. ## How it works 1. **Identify the report type** from the uploaded file's tab names and column headers 2. **Run the analysis script** which performs report-specific checks 3. **Present findings** in a structured summary with the most important items first ## Step 1: Identify the report type When the user uploads an XLSX file, first identify which TRES report it is. Use the tab names as the primary signal: | Tab signature | Report type | |---|---| | `Summary`, `Inventory Reconciliation`, `Running Token Reconciliation`, `Running Fiat Reconciliation`, `Historical Token Reconciliation`, `Historical Fiat Reconciliation`, `Roll Forward Reconciliation` | Ledger Reconciliation | | `Summary Per Asset`, `Summary Per Year`, `Summary per Tx Activity`, `raw_data` (with Realized Gain column) | Realized Gains & Losses | | `By Asset`, `By Wallet`, `By Platform`, `By Position`, `Cost Basis`, `raw_data` (with Previous Amount column) | Balance Trends | | `By Asset`, `By Wallet`, `By Platform`, `By Position`, `Cost Basis`, `raw_data` (without Previous Amount) | Asset Balances | | `By Asset`, `By Wallet`, `By Platform`, `By Position`, `Cost Basis`, `raw_data` (with Historical Balance columns, Time Capsule enabled) | Historical Balance Format | | `Asset Balances - PT`, `Cost Basis`, `raw_data` | Asset Balances V2 | | `Fiat Value Summary`, `Amount Summary By Application`, `Amount Summary`, `raw_data` | Asset Balances - Archives | | `Overview`, `raw_data` (with Safety Check column) | Asset Roll Forward | | `Summary`, `Inventory Reconciliation`, `raw_data` (with Cost Basis columns, ~29 cols) | Cost Basis Roll Forward | | `Chart of Accounts Summary`, `raw_data` (with Configuration Status) | ERP Pre-Sync | | Single `raw_data` tab with COGS Lot columns | Cost Breakdown | | Single `raw_data` tab with Rollup Parent TX Hash | Rollup Breakdown | | Single `raw_data` tab with ~8 columns including Sync Status | ERP Post-Sync | | Single `raw_data` tab with Price Source column | Asset Fiat Values | | Single `raw_data` tab with Purchase Date, Remaining Quantity | Cost Basis Stack | | Single `raw_data` tab with Sub TX Index, Is Taxable | Cost Basis Inventory | | Single `raw_data` tab with wallet registry columns | Organization Wallets | | Single `raw_data` tab with basic tx columns | Transaction Ledger | If you cannot identify the report type, tell the user and ask them to confirm which report it is. ## Step 2: Run the analysis Use the Python script at `scripts/analyze_report.py` to extract data from the XLSX file. Run it like this: ```bash python /path/to/skill/scripts/analyze_report.py "/path/to/uploaded/file.xlsx" --output /path/to/output.json ``` The script outputs a JSON file with extracted metrics. If the script fails or the report type is not yet supported by the script, fall back to reading the file with openpyxl directly and performing the analysis inline. ### What to analyze per report type Read `references/analysis-playbook.md` for the detailed analysis checklist for each report type. The general pattern is: **For reconciliation reports** (Ledger Reconciliation, Asset Roll Forward, Cost Basis Roll Forward): - Check columns: how many pass vs. fail? - Which assets/wallets have the largest discrepancies? - What is the total slippage or gap amount? - Are there patterns (same wallet, same asset, same platform)? **For balance reports** (Asset Balances, Historical Balance Format, V2, Archives, Balance Trends): - Total portfolio value - Top holdings by fiat value - Any zero-balance or negative-balance entries? - For Balance Trends: largest movers (biggest absolute change) - Unverified tokens or missing prices **For transaction reports** (Transaction Ledger, Realized Gains & Losses, Cost Breakdown): - Total transaction count and date range - Largest transactions by fiat value - Total realized gains/losses (if applicable) - Classification breakdown (how many of each type) - Any unclassified transactions? **For cost basis reports** (Cost Basis Stack, Cost Basis Inventory, Cost Basis Roll Forward): - Total cost basis and unrealized gains - Lots with largest unrealized losses (tax-loss harvesting candidates) - Age of lots (any very old lots?) - Impairment amounts if applicable **For ERP reports** (Pre-Sync, Post-Sync): - Configuration status breakdown (how many ready vs. misconfigured) - Missing account mappings - Failed syncs and error patterns - Debit/credit balance check ## Step 3: Present findings Structure your response as follows. Keep it concise -- the user wants insights, not a data dump. ### Format Start with a one-line identification of what the report is and the period it covers. Then present findings in order of importance: 1. **Red flags** (if any): failed checks, large discrepancies, missing data, failed syncs 2. **Key metrics**: total value, count, gains/losses -- the headline numbers 3. **Notable items**: largest transactions, top holdings, biggest movers -- things worth knowing 4. **Action items** (if any): specific things the user should investigate or fix End with a brief note about what the user can ask as a follow-up (e.g. "I can drill into any specific asset or wallet if you want a closer look"). ### Style rules - Use actual numbers from the data, not vague descriptions - Round large numbers sensibly ($1,234,567.89 -> $1.23M) - No em-dashes or en-dashes (use -- instead) - Keep the total response under 500 words unless the user asks for more detail - If there are many findings, prioritize the top 5 and mention "N more items" the user can ask about
© Nadav Gilliam · MIT · anthropics/claude-plugins-community