← Back to Skills Marketplace
schchit

Claimback Radar

by JEP (Judgment Event Protocol) · GitHub ↗ · v1.0.5 · MIT-0
cross-platform ✓ Security Clean
123
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install claimback-radar
Description
Scans emails and bills to extract billing data, detect refund opportunities, subscription risks, and generate actionable savings recommendations.
README (SKILL.md)

Skill Definition: claimback_radar

🔑 REQUIRED CREDENTIAL: OPENAI_API_KEY environment variable (or pass api_key directly to ClaimbackRadar).
⚠️ EXTERNAL DATA FLOW: User-provided text content is transmitted to OpenAI's API. Review OpenAI's data retention and privacy policies before use.
🛡️ DATA PRIVACY NOTICE: Do not submit sensitive financial or identity data unless you explicitly accept this external data flow.

Description

Scans user emails and bills to discover hidden refunds, subscription traps, and savings opportunities.

Functions

Function 1: extract

Extracts structured subscription / billing data from unstructured text.

Input: Raw email or bill text Output: confirmation_card (JSON)

Function 2: detect_and_recommend

Detects risks and generates actionable receipts.

Input: confirmation_card + user context Output: action_receipts + risk_flags

Invocation Schema

See schema/input.json

Output Schema

See schema/output.json

Example

See examples/netflix_email.md

Security Notes

  • The CLI entrypoint (main.py) explicitly loads .env if present and warns the user.
  • Do not commit .env files containing real API keys to version control.
  • For production use, prefer explicit api_key injection over implicit environment loading.
  • Ensure no unrelated secrets are stored in .env in directories where you run this tool.
Usage Guidance
This skill is coherent and appears to do what it says: it sends the email/bill text you provide to OpenAI to extract billing/subscription information and generate recommendations. Before installing or using it, consider: 1) Privacy — any text you feed (emails, bills) will be transmitted to OpenAI; do not include highly sensitive PII or financial account details unless you accept OpenAI's data handling. 2) .env behavior — main.py will load a local .env if present (it warns you), so ensure that file does not contain unrelated secrets you don't want read at runtime. 3) Supply OPENAI_API_KEY securely (prefer explicit api_key injection over leaving keys in .env). 4) If you need stricter guarantees, review the prompts (prompts/system.txt) and run the tests locally to confirm behavior. Overall: functionality is proportionate, main risk is expected external data exposure — evaluate whether that privacy tradeoff is acceptable for your use case.
Capability Analysis
Type: OpenClaw Skill Name: claimback-radar Version: 1.0.5 The claimback-radar skill is an AI-powered tool designed to extract billing and subscription data from text using the OpenAI API. The implementation is transparent, featuring clear documentation in SKILL.md and README.md, explicit privacy warnings regarding external data flow, and a manifest (clawhub.json) that correctly identifies its network requirements. The code (main.py, runner.py) follows its stated purpose without any signs of malicious execution, obfuscation, or unauthorized data exfiltration.
Capability Tags
cryptocan-make-purchasesrequires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
Name/description (scan emails/bills, detect refunds/subscriptions) maps to the code and declared requirements. The package depends only on the OpenAI SDK, python-dotenv and pydantic which are reasonable for the described LLM-driven extraction tasks. Required credential OPENAI_API_KEY is expected and used by src/runner.py.
ℹ Instruction Scope
Runtime instructions and code explicitly transmit user-provided email/bill text to OpenAI for processing (this is documented and warned about in SKILL.md and README). The code only reads the provided input JSON and the local system prompt file; it does not access unrelated system files or additional credentials. The notable scope issue is the privacy impact of sending potentially sensitive financial/identity data to an external API — the skill does warn users not to submit sensitive info.
✓ Install Mechanism
No custom or remote arbitrary downloads. The declared install path is pip installing requirements.txt (openai, python-dotenv, pydantic). This is a standard package install model with traceable dependencies.
✓ Credentials
Only OPENAI_API_KEY is required (declared in clawhub.json and SKILL.md) which is proportionate to the LLM usage. The only other runtime behavior is optional loading of a local .env file (main.py uses python-dotenv) — this is warned in multiple places but still a privacy footgun if users have unrelated secrets in .env.
✓ Persistence & Privilege
No 'always' privilege requested. The skill does not persist or modify other skills or system-wide configs. It reads input files and system prompt, and makes outbound calls only to OpenAI (as documented).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install claimback-radar
  3. After installation, invoke the skill by name or use /claimback-radar
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
claimback-radar 1.0.5 - Added project configuration files: `clawhub.json` and `pyproject.toml`. - Updated data privacy notice to include identity data, not just financial data. - Expanded security notes to warn against storing unrelated secrets in `.env`.
v1.0.4
claimback-radar 1.0.4 - Updated SKILL.md to add a clearer data privacy notice and visual highlights for key security information. - Added _meta.json metadata file. - Removed pyproject.toml.
v1.0.3
# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.0.3] - 2026-04-23 ### Fixed - Unified package version to `1.0.3` across `pyproject.toml` and registry metadata - Added prominent `OPENAI_API_KEY` credential declaration to `README.md` and `SKILL.md` first lines - Removed unused `pydantic` dependency from `requirements.txt` and `pyproject.toml` - Clarified external data flow warning (OpenAI API) in registry metadata ## [0.1.0] - 2026-04-22 ### Added - **Function 1: Structured Extraction** — Scans raw email/bill text and extracts service name, provider, amount, billing cycle, next charge date, refund deadline, warranty expiry, and cancellation method - **Function 2: Risk Detection & Action Generation** — Detects risks (upcoming charges, refund windows closing, unused services, price hikes, warranty expiring) and generates prioritized action receipts with deadlines and estimated savings - **Schema definitions** — `schema/input.json` and `schema/output.json` for strict validation of Skill invocation and response - **System prompt** — `prompts/system.txt` containing the core extraction and detection logic for LLM execution - **Reference implementation** — `src/runner.py` with `ClaimbackRadar` class, runnable via `main.py` CLI or imported as a module - **Examples** — Netflix subscription and Amazon Prime renewal cases with expected input/output - **Unit tests** — `tests/test_runner.py` covering prompt loading, valid output structure, and error handling - **Paper reference** — Links to Zenodo preprint (DOI: 10.5281/zenodo.19678205) and MDPI *Information* submission [1.0.3]: https://github.com/schchit/claimback-radar/releases/tag/v1.0.3 [0.1.0]: https://github.com/schchit/claimback-radar/releases/tag/v0.1.0
v1.0.2
# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [0.1.1] - 2026-04-22 ### Fixed - Added prominent `OPENAI_API_KEY` credential declaration to `README.md` and `SKILL.md` first lines - Removed unused `pydantic` dependency from `requirements.txt` - Clarified external data flow warning (OpenAI API) in registry metadata ## [0.1.0] - 2026-04-22 ### Added - **Function 1: Structured Extraction** — Scans raw email/bill text and extracts service name, provider, amount, billing cycle, next charge date, refund deadline, warranty expiry, and cancellation method - **Function 2: Risk Detection & Action Generation** — Detects risks (upcoming charges, refund windows closing, unused services, price hikes, warranty expiring) and generates prioritized action receipts with deadlines and estimated savings - **Schema definitions** — `schema/input.json` and `schema/output.json` for strict validation of Skill invocation and response - **System prompt** — `prompts/system.txt` containing the core extraction and detection logic for LLM execution - **Reference implementation** — `src/runner.py` with `ClaimbackRadar` class, runnable via `main.py` CLI or imported as a module - **Examples** — Netflix subscription and Amazon Prime renewal cases with expected input/output - **Unit tests** — `tests/test_runner.py` covering prompt loading, valid output structure, and error handling - **Paper reference** — Links to Zenodo preprint (DOI: 10.5281/zenodo.19678205) and MDPI *Information* submission [0.1.1]: https://github.com/schchit/claimback-radar/releases/tag/v0.1.1 [0.1.0]: https://github.com/schchit/claimback-radar/releases/tag/v0.1.0
v1.0.1
claimback-radar v1.0.1 - Added requirements for `OPENAI_API_KEY` and clarified API key usage instructions. - Added explicit data privacy notice about sending user content to OpenAI's API. - Included security guidance regarding `.env` usage, warning against committing secrets and preferring explicit API key passing. - No changes to code functionality.
v1.0.0
# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [0.1.0] - 2026-04-22 ### Added - **Function 1: Structured Extraction** — Scans raw email/bill text and extracts service name, provider, amount, billing cycle, next charge date, refund deadline, warranty expiry, and cancellation method. - **Function 2: Risk Detection & Action Generation** — Detects risks (upcoming charges, refund windows closing, unused services, price hikes, warranty expiring) and generates prioritized action receipts with deadlines and estimated savings. - **Schema definitions** — `schema/input.json` and `schema/output.json` for strict validation of Skill invocation and response. - **System prompt** — `prompts/system.txt` containing the core extraction and detection logic for LLM execution. - **Reference implementation** — `src/runner.py` with `ClaimbackRadar` class, runnable via `main.py` CLI or imported as a module. - **Examples** — Netflix subscription and Amazon Prime renewal cases with expected input/output. - **Unit tests** — `tests/test_runner.py` covering prompt loading, valid output structure, and error handling. - **Paper reference** — Links to Zenodo preprint (DOI: 10.5281/zenodo.19678205) and MDPI *Information* submission. [0.1.0]: https://github.com/schchit/claimback-radar/releases/tag/v0.1.0
Metadata
Slug claimback-radar
Version 1.0.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is Claimback Radar?

Scans emails and bills to extract billing data, detect refund opportunities, subscription risks, and generate actionable savings recommendations. It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.

How do I install Claimback Radar?

Run "/install claimback-radar" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Claimback Radar free?

Yes, Claimback Radar is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Claimback Radar support?

Claimback Radar is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Claimback Radar?

It is built and maintained by JEP (Judgment Event Protocol) (@schchit); the current version is v1.0.5.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments