← 返回 Skills 市场
paulgnz

XPR Crypto Tax

作者 paulgnz · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
718
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install xpr-tax
功能描述
Generate detailed crypto tax reports for XPR Network activity with support for New Zealand and United States regional tax rules and cost basis methods.
安全使用建议
This skill appears to implement the advertised crypto-tax functionality, but there are transparency issues you should address before installing: - Expect the skill to call external APIs (Saltant, Metal X, Hyperion, CoinGecko) and to upload report files (PDF + CSVs) as part of its normal workflow. Confirm you trust the platform's store_deliverable and xpr_deliver_job endpoints and any third-party URLs used for delivery. Uploading CSVs means financial and transaction data will be transmitted off the agent environment. - The code reads COINGECKO_API_KEY (optional) and RATE_CACHE_PATH even though the manifest does not list these env vars. If you provide a CoinGecko key, verify it is scoped appropriately; if you do not, the skill falls back to limited/no-key behavior. - By default the skill will create a data/rate-cache.json in the agent working directory. If you prefer to control where files are written, set RATE_CACHE_PATH to a safe location (or make the skill's working directory read-only) and audit the cache file contents policy. - Review the bundled dist/index.js (included) yourself or ask the publisher for a provenance statement. The included code is not obviously malicious, but the manifest omissions (env/config) and mandatory multi-file upload step are non-trivial and warrant caution. - If you want to proceed: run the skill with non-sensitive test data first, confirm the exact endpoints used for uploads/delivery, and consider providing a throwaway CoinGecko key or limiting the RATE_CACHE_PATH to a directory you control. If the publisher can update the manifest to declare COINGECKO_API_KEY and RATE_CACHE_PATH (and describe their use), that would increase transparency and reduce risk.
功能分析
Type: OpenClaw Skill Name: xpr-tax Version: 1.0.0 The OpenClaw skill 'xpr-tax' is classified as benign. Its primary function is crypto tax reporting, which it performs by querying legitimate public APIs (Saltant, Metal X, CoinGecko) for account balances, DEX trades, and on-chain transfers. It processes this data to calculate gains/losses and generate a tax report in Markdown and CSV formats. The skill accesses `process.env.COINGECKO_API_KEY` for API authentication, which is a standard and expected practice. Crucially, the `dist/index.js` file (the executable code) does not contain any file system operations (e.g., for persistent caching), unlike the provided `src/index.ts`. The `SKILL.md` instructions are clear, align with the stated purpose, and do not exhibit any prompt injection attempts or instructions for unauthorized actions. There is no evidence of data exfiltration to unauthorized endpoints, persistence mechanisms, or malicious obfuscation.
能力评估
Purpose & Capability
Name/description (XPR crypto tax reporting for NZ/US) aligns with the code and SKILL.md: it calls on-chain APIs, parses DEX CSVs, computes gains, and generates reports. Requiring price data (CoinGecko) and on-chain APIs is reasonable for this purpose. However, the skill's package metadata lists no required env vars while the code relies on environment variables (COINGECKO_API_KEY, RATE_CACHE_PATH), which is an inconsistency.
Instruction Scope
SKILL.md instructs the agent to fetch balances/trades/transfers, compute gains, and then upload a PDF and two CSVs and call a delivery job (xpr_deliver_job). That workflow is coherent for a reporting tool, but the instructions mandate uploading all files and making an external 'deliver' call in a single run — a behavior with data-exfiltration implications if endpoints or storage targets are untrusted. SKILL.md also claims 'all tools are read-only', but the code persists a local rate cache to disk (not strictly read-only).
Install Mechanism
No install spec is provided (instruction-only installation), which is low risk compared to arbitrary downloads. The package contains JS/TS source and a bundled dist file that will run on the platform — no external installers or unusual download URLs are present.
Credentials
skill.json declares no required environment variables, but the code reads process.env.COINGECKO_API_KEY (to enable expanded CoinGecko history) and process.env.RATE_CACHE_PATH (to override where a persistent JSON rate cache is stored). COINGECKO_API_KEY is expected for price history (reasonable), but its absence from manifest is an oversight. RATE_CACHE_PATH (default: ./data/rate-cache.json) means the skill will read/write files on disk; this file-write capability is disproportionate relative to the manifest which states no config paths. Lack of explicit env declaration reduces transparency and is a red flag.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges. However, it maintains a persistent local JSON rate cache (writes to a data directory by default) which means it will create files under the agent's working directory. This is ordinary for caching but should be noted.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install xpr-tax
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /xpr-tax 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
6 tools: balance snapshots, DEX trade history, transfer categorization, capital gains calculation, full tax reports with NZ regional support
v0.2.11
- Added SKILL.md with comprehensive documentation and usage instructions. - Detailed workflow for generating crypto tax reports, supporting New Zealand and US regions. - Included tables for transfer categorization, tax rules, and report delivery steps. - Clarified regional differences (NZ/US tax years, capital gains treatment, rate sources). - Documented known limitations and important operational notes for accurate reporting.
元数据
Slug xpr-tax
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 2
常见问题

XPR Crypto Tax 是什么?

Generate detailed crypto tax reports for XPR Network activity with support for New Zealand and United States regional tax rules and cost basis methods. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 718 次。

如何安装 XPR Crypto Tax?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install xpr-tax」即可一键安装,无需额外配置。

XPR Crypto Tax 是免费的吗?

是的,XPR Crypto Tax 完全免费(开源免费),可自由下载、安装和使用。

XPR Crypto Tax 支持哪些平台?

XPR Crypto Tax 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 XPR Crypto Tax?

由 paulgnz(@paulgnz)开发并维护,当前版本 v1.0.0。

💬 留言讨论