subscription-detection

Detect recurring charges and subscriptions from transaction history using five criteria.

6|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/peerjakobsen/smartspender --skill subscription-detection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subscription-detection
Source: https://github.com/peerjakobsen/smartspender/tree/main/skills/subscription-detection
Command: npx skills add https://github.com/peerjakobsen/smartspender --skill subscription-detection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically identifies recurring charges and subscriptions from transaction history to streamline personal finance management.

Core Features & Use Cases

  • Automatic detection of recurring charges across merchants with tolerance for frequency variations and amount changes.
  • Learning-driven corrections update the detection rules via learnings/subscriptions.md to improve accuracy over time.
  • Reporting exports a subscriptions.csv with merchant, frequency, amount, first_seen, last_seen, and status for budgeting and planning.

Quick Start

Analyze your recent transactions to surface recurring subscriptions and suggest next steps for cancellation or optimization.

Frequently Asked Questions about subscription-detection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect recurring charges in my bank transactions?

Recurring charges are identified by matching same merchant, regular frequency, amount tolerance within ±5%, minimum 3 occurrences, and recency within the expected interval plus 7 days. The Skill exports merchant, frequency, and amount data to subscriptions.csv.

How do I find and manage subscriptions in my transaction history?

Finding subscriptions involves scanning transaction history for recurring patterns across merchants. The Skill detects frequency variations and amount changes, then exports merchant, frequency, amount, first_seen, last_seen, and status to subscriptions.csv for management and planning.

What is the best way to automate subscription detection for personal finance?

Automating subscription detection involves applying detection criteria—same merchant, regular frequency, amount tolerance ±5%, minimum 3 occurrences, and recency within expected interval + 7 days—then recording results in subscriptions.csv for budgeting and planning.

Does subscription detection work with categorized bank transactions?

Subscription detection applies across categorized bank transactions, using five criteria to identify recurring charges. It supports learning corrections via learnings/subscriptions.md to improve accuracy over time for budgeting and expense optimization.

Why are my recurring charges not being detected with amount variations?

Recurring charges may fail detection if amount variations exceed the ±5% tolerance, or if fewer than 3 occurrences exist, or if the transaction falls outside the expected interval plus 7 days. All five criteria must be met for successful detection.

Can I correct false positives in subscription detection results?

False positives can be corrected using the learning-driven feature, which updates detection rules via learnings/subscriptions.md. This improves accuracy over time by incorporating user corrections into future subscription detection analysis.