Skip to content
Back to search

rotki-agent-tools

MarketplaceWorks with Claude CodeGitHub

Unofficial Claude Code skills for rotki users and contributors.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nuthatch-org--rotki-agent-tools/badge.svg)](/listings/nuthatch-org--rotki-agent-tools)

HTML

<a href="/listings/nuthatch-org--rotki-agent-tools"><img src="/api/listings/nuthatch-org--rotki-agent-tools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add nuthatch-org/rotki-agent-tools
/plugin install rotki-agent-tools@rotki-agent-tools

Or copy a folder from `skills/` into `~/.claude/skills/`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "rotki-agent-tools",
  3. "description": "Unofficial Claude Code skills for rotki users and contributors.",
  4. "owner": {
  5. "name": "nuthatch-org",
  6. "url": "https://github.com/nuthatch-org"
  7. },
  8. "plugins": [
  9. {
  10. "name": "rotki-agent-tools",
  11. "source": "./",
  12. "description": "Unofficial agent skills for rotki: rotki-doctor, rotki-reconcile, rotki-decoder.",
  13. "repository": "https://github.com/nuthatch-org/rotki-agent-tools",
  14. "license": "MIT"
  15. }
  16. ]
  17. }
README.md · README · 64 lines
  1. # rotki-agent-tools
  2. Unofficial Claude Code skills for people who use or contribute to [rotki](https://github.com/rotki/rotki),
  3. the open-source portfolio tracking and accounting app. Packaged as a Claude Code plugin.
  4. This project is not made by, affiliated with or endorsed by rotki or Rotki Solutions GmbH.
  5. "rotki" is their name and their software.
  6. | Skill | What it does |
  7. |---|---|
  8. | `rotki-doctor` | Finds rotki's log files (desktop on macOS, Linux and Windows, or Docker), scans them for known failure signatures (indexer and price-oracle rate limits, history ranges no indexer covers, RPC node failures, missing prices, database upgrade errors, crashes), explains each one and proposes the fix. Every signature cites the rotki source line that emits it. |
  9. | `rotki-reconcile` | Checks a PnL CSV export before it is used for taxes: events valued at zero, disposals with missing acquisitions, quiet stretches that may be uncovered history, and optionally on-chain transactions of the user's addresses that never reached the export, using a self-hosted nuthatch nest. Reports data gaps; gives no tax advice. |
  10. | `rotki-decoder` | Drafts an upstream rotki contribution for a transaction rotki leaves undecoded or decodes wrongly: decoder, VCR test, changelog line and PR body, checked against the review objections rotki maintainers actually raise. |
  11. The scripts are Python standard library only and are meant to be run isolated (`python3 -I`).
  12. ## Install
  13. ```
  14. /plugin marketplace add nuthatch-org/rotki-agent-tools
  15. /plugin install rotki-agent-tools@rotki-agent-tools
  16. ```
  17. Or copy a folder from `skills/` into `~/.claude/skills/`.
  18. ## The Premium boundary
  19. rotki sells an official MCP server as part of [rotki Premium](https://rotki.com), which
  20. gives an agent access to your portfolio. These skills are deliberately not a substitute for it:
  21. - They never read balances, holdings, transactions or history from rotki's API, and never ask
  22. you to paste them.
  23. - `rotki-doctor` works from rotki's own log files, plus at most a few small read-only status
  24. calls: version and log level, a handful of settings (indexer order, price oracle order,
  25. timeouts), the names of services that have a key set (never the keys) and the names and hosts
  26. of configured RPC nodes.
  27. - `rotki-reconcile` works only from a CSV you exported yourself, and optionally from your own
  28. indexer on your own machine.
  29. - `rotki-decoder` works from public chain data and the rotki source tree.
  30. If you want an agent to analyse your portfolio, use rotki's MCP. If rotki is misbehaving, or you
  31. want to know whether an export is complete, or you want to fix a decoder upstream, these help.
  32. ## Mentions of nuthatch
  33. `rotki-doctor` may suggest a self-hosted nuthatch nest as an indexer, but only where third-party
  34. indexers genuinely cannot serve your history on an EVM chain. It is not part of a rotki release.
  35. The unofficial fork [nuthatch-org/rotki-nuthatch](https://github.com/nuthatch-org/rotki-nuthatch)
  36. offers it on every EVM chain; the open upstream pull request
  37. [rotki/rotki#13686](https://github.com/rotki/rotki/pull/13686) adds it for Ethereum only.
  38. ## Tests
  39. ```
  40. python3 -I -m unittest discover -s tests/rotki_doctor
  41. python3 -I -m unittest discover -s tests/rotki_reconcile
  42. ```
  43. Fixtures are synthetic: log lines rebuilt from rotki's own message strings, and PnL exports in
  44. the column layout rotki writes.
  45. ## Licence
  46. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.