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.