Skip to content

Credit card rewards optimizer for Clawdbot. Recommends the best card for every purchase, tracks annual caps, calculates fee ROI, identifies coverage gaps, and suggests new cards to maximize rewards.

License

Notifications You must be signed in to change notification settings

ScotTFO/card-optimizer-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’³ Card Optimizer β€” Credit Card Rewards Maximizer

A Clawdbot skill that helps you maximize credit card rewards by always recommending the best card for every purchase. Tracks annual spending caps, calculates annual fee ROI, identifies coverage gaps, and suggests new cards based on your spending patterns.

Features

  • Purchase recommendations β€” Instantly tells you which card to use for any purchase or category
  • Cap-aware suggestions β€” Tracks annual/quarterly spending caps and warns when you're close to exhausting bonus rates
  • Amex fallback warnings β€” Always provides a Visa/Mastercard alternative when recommending Amex cards
  • Annual fee ROI analysis β€” Calculates whether each fee card is earning its keep based on your spending
  • Gap analysis β€” Identifies categories where you're leaving rewards on the table
  • New card recommendations β€” Suggests cards that would add the most value based on your spending patterns
  • Rotating quarterly category management β€” Tracks Chase Freedom Flex, Discover It, and other rotating category cards with activation reminders
  • Merchant-to-category mapping β€” Automatically maps merchants (Costco, Kroger, DoorDash, etc.) to the correct reward category
  • Point/mile valuation support β€” Compares cashback and points cards using cents-per-point valuations for apples-to-apples comparison

Installation

Via ClawdHub (coming soon)

clawdhub install card-optimizer

Manual Installation

  1. Copy SKILL.md into your Clawdbot workspace:
    skills/card-optimizer/SKILL.md
    
  2. Create the data directory for your personal card data:
    data/card-optimizer/
    
  3. Start chatting β€” the skill will walk you through setup on first use.

Setup

The first time you use the skill, it will:

  1. Ask what credit cards you have β€” Just name them and it will look up current reward structures
  2. Build your card database β€” Creates data/card-optimizer/cards.json with all your cards, rates, caps, and categories
  3. Ask for spending estimates β€” Optional monthly estimates per category (groceries, gas, dining, etc.) to power ROI calculations and gap analysis
  4. Generate a category map β€” Precomputes the optimal card for every spending category
  5. Run an initial optimization report β€” Shows your best card per category and identifies any gaps

Data Structure

This skill follows Clawdbot's data separation convention:

skills/card-optimizer/
  └── SKILL.md          # Skill logic (this repo β€” shareable, portable)

data/card-optimizer/
  └── cards.json        # Your cards, rates, caps, spending estimates (personal β€” not shared)

Skills get updated independently of your data. Your card configurations persist across skill updates.

Usage Examples

You Say What Happens
"Which card for groceries?" Recommends your best grocery card with rate, cap info, and fallback
"I'm buying gas at Shell" Maps Shell β†’ gas category β†’ best card recommendation
"Annual fee worth it?" ROI analysis for every card with an annual fee
"What cards should I get?" New card recommendations based on your spending gaps
"Card optimization report" Full gap analysis with actionable suggestions
"Add a new card" Walks through adding a card and recalculates optimal assignments
"Remove a card" Removes a card and shows updated coverage
"Activate Q2 categories" Updates quarterly activation status for rotating category cards
"Does Costco take Amex?" Network acceptance info (Costco is Visa-only in store)
"What are my cards?" Lists all your cards with key rates
"Update my spending estimates" Revises your estimated monthly spending per category

Requirements

  • Clawdbot v1.0+
  • No API keys required
  • No external services β€” runs entirely within your Clawdbot workspace

License

MIT β€” Copyright 2026 Scott (ScotTFO)

About

Credit card rewards optimizer for Clawdbot. Recommends the best card for every purchase, tracks annual caps, calculates fee ROI, identifies coverage gaps, and suggests new cards to maximize rewards.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published