card-full

Return a compact full report for one major-US credit card - fees, welcome offer, earning rates, redemption, credits, travel benefits, protections, mechanics, eligibility, and strat…

jiahongc

@jiahongc

Install

$ openclaw skills install @jiahongc/card-full

Card Full

Research any major US credit card and return a compact, complete report.

When To Use

When the user asks for a full credit card review, breakdown, or "tell me about [card]". Trigger phrases: "card-full", "full report", "tell me about the [card name]", "review [card name]".

Workflow

  1. Resolve card identity - normalize the input, fix abbreviations, and match to one exact card variant.
  2. Run the main search first - use WebSearch by default to discover the issuer page plus likely secondary sources. If BRAVE_API_KEY is available and curl exists, you may use one Brave search instead for faster results.
  3. Fetch issuer + secondary pages - fetch the issuer page and up to 3 approved secondary pages as needed.
  4. Search for best public offer - run a second search only after a short delay, and only after the first fetch pass is complete.
  5. Search for historical offers - run a third search only after another short delay, preserving historical-offer coverage without bursting requests.
  6. Recover welcome-offer data explicitly - if the issuer page does not expose the live offer cleanly, use approved secondary sources to identify the current public offer and the best public offer.
  7. Compile - assemble the report using the required sections below.
  8. Confidence - flag uncertain or conflicting claims in the Confidence Notes section, especially around welcome offers.

Step 1: Card Identity Resolution

Normalize the card name and resolve to an exact issuer + family + variant.

Common Abbreviations

Only shorthands and ambiguous names need entries here. Cards with full, unambiguous names (e.g., "Chase Marriott Bonvoy Boundless", "Chase United Explorer", "American Express Hilton Honors Aspire") are resolved via search - no table entry needed.

InputResolved
CSPChase Sapphire Preferred
CSRChase Sapphire Reserve
CFUChase Freedom Unlimited
CFFChase Freedom Flex
CIPChase Ink Business Preferred
CICChase Ink Business Cash
CIUChase Ink Business Unlimited
Amex GoldAmerican Express Gold Card
Amex PlatAmerican Express Platinum Card
Amex Biz GoldAmerican Express Business Gold Card
Amex Biz PlatAmerican Express Business Platinum Card
Amex Blue Biz PlusAmerican Express Blue Business Plus Card
Amex Blue Biz CashAmerican Express Blue Business Cash Card
Venture XCapital One Venture X Rewards Credit Card
Venture X BusinessCapital One Venture X Business Card
SavorCapital One SavorOne / Savor (ambiguous - ask)
Spark Cash PlusCapital One Spark Cash Plus
Spark MilesCapital One Spark Miles
Double CashCiti Double Cash Card
Custom CashCiti Custom Cash Card
Ink PreferredChase Ink Business Preferred
Ink CashChase Ink Business Cash
Ink UnlimitedChase Ink Business Unlimited
BiltBilt Blue / Obsidian / Palladium (ambiguous - ask)
RobinhoodRobinhood Gold Card / Cash Card (ambiguous - ask)
Aviator RedBarclays AAdvantage Aviator Red World Elite Mastercard
Wyndham RewardsBarclays Wyndham Rewards Earner Card / Plus / Business (ambiguous - ask)
Altitude ReserveU.S. Bank Altitude Reserve Visa Infinite Card
Altitude ConnectU.S. Bank Altitude Connect Visa Signature Card
Altitude GoU.S. Bank Altitude Go Visa Signature Card
Delta GoldAmerican Express Delta SkyMiles Gold Card
Delta PlatinumAmerican Express Delta SkyMiles Platinum Card
Delta ReserveAmerican Express Delta SkyMiles Reserve Card
Delta Biz GoldAmerican Express Delta SkyMiles Gold Business Card
Delta Biz PlatAmerican Express Delta SkyMiles Platinum Business Card
Delta Biz ReserveAmerican Express Delta SkyMiles Reserve Business Card

Business vs Personal

Both personal and business credit cards are supported. If the user specifies "business" or "biz", resolve to the business variant. If a card name exists in both versions and the user does not specify, treat as ambiguous and ask.

Ambiguity Rules

  • If the input maps to 2+ plausible variants (e.g., "Chase Sapphire" could be Preferred or Reserve), return a numbered choice list and stop. Do not guess.
  • If no match exists, return: "Could not match a card. Try including the full card name with issuer."

Supported Issuers

American Express, Bank of America, Barclays, Bilt, Capital One, Chase, Citi, Discover, Robinhood, U.S. Bank, Wells Fargo. If the card is from an unsupported issuer, return: "This card is not from a supported issuer."

Step 2: Search

Use the platform's WebSearch and WebFetch tools by default. If BRAVE_API_KEY is available and the runtime also provides curl, you may use Brave Search API instead for faster and more repeatable search results.

Optional Brave template:

curl -sS "https://api.search.brave.com/res/v1/web/search?q=CARD+NAME+review+welcome+offer&count=10" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Parse the JSON response - results are in .web.results[] with .title, .url, .description fields.

Search Query Design (critical for offer accuracy)

Generic CARD NAME review welcome offer queries surface SEO pages that update slowly and can be months stale. Run three query shapes in the main search:

  1. Generic - CARD NAME review welcome offer <year> (finds issuer page + reviews)
  2. Offer-structure terms - append the kinds of non-mile components issuers use to differentiate offers: certificate, round-trip, statement credit, companion, travel credit, elevated. e.g. Delta Reserve offer round-trip flight certificates 50,000
  3. Freshness-targeted - site:doctorofcredit.com CARD NAME offer and CARD NAME new offer <month> <year> / CARD NAME welcome offer ending. Doctor of Credit tracks offer rounds the fastest (often same-day updates with "live now" / "expired" tags). Issuer newsrooms (e.g. news.delta.com) announce card refreshes - search <issuer> <card family> card news <year>.

Date-based queries are meaningless without knowing today's date - always anchor with the current month/year.

Assess freshness of every result before trusting it:

  • A page title or snippet saying "current", "live", or "<year>" does NOT mean fresh. Look for update timestamps in the page body.
  • If a page describes an offer with a "valid through"/"expires"/"ending" date, check it against today.
  • Prefer pages updated within the last ~30 days for the live offer; treat older pages as historical evidence only.

Search Budget Rule

Treat search as scarce and paced. Built-in web search is the default path; if Brave mode is used, it may rate-limit after only a few requests.

  • Searches may be required for the main report, best public offer, and historical offers.
  • Do not fire those searches in one burst.
  • Serialize them.
  • Wait briefly between searches.
  • If Brave returns 429, back off before trying the next search.
  • If Brave is unavailable, continue with WebSearch + WebFetch.
  • Preserve historical-offer coverage when possible, but never at the cost of bursty request patterns.

Pacing Rule

When multiple searches are needed, use this pacing. Apply it to Brave searches and also avoid bursting platform WebSearch requests:

  1. Run the main search.
  2. Fetch issuer + secondary pages.
  3. Wait about 2 to 5 seconds before the next search.
  4. Run the best-public-offer search.
  5. Wait about 2 to 5 seconds before the historical-offers search.
  6. Run the historical-offers search.

If a search returns 429:

  1. Wait about 8 to 15 seconds.
  2. Retry once if the information is important and still missing.
  3. If it still fails, continue the report with the best evidence already gathered and mark the affected section accordingly.

Source Policy

  • Issuer-first for fees/terms/benefits, but not issuer-only for welcome offers.
  • Use the issuer page as the baseline truth source for annual fee, earning rates, credits, protections, and restrictions.
  • For welcome offers, always compare against approved secondary sources because the best public offer may be broader than the issuer page or the issuer page may not extract cleanly.
  • Max 5 secondary sources from this approved list:
    1. NerdWallet (nerdwallet.com) - preferred
    2. The Points Guy (thepointsguy.com) - preferred
    3. Doctor of Credit (doctorofcredit.com)
    4. Bankrate (bankrate.com)
    5. One Mile at a Time (onemileatatime.com)
    6. Upgraded Points (upgradedpoints.com)
  • Prefer 2 to 3 secondary pages for welcome-offer verification when the issuer page is weak, JS-heavy, stale, or missing offer text.
  • Stop early once all required sections are covered.
  • Disallowed: Reddit, Facebook, Instagram, TikTok, X, YouTube, referral links, user forums.

Issuer Domains (for classifying results, not constraining searches)

IssuerDomains
American Expressamericanexpress.com, aboutamex.com
Bank of Americabankofamerica.com
Barclayscards.barclaycardus.com
Biltbfrrewards.com
Capital Onecapitalone.com
Chasechase.com, media.chase.com
Citiciti.com, citicards.com
Discoverdiscover.com
Robinhoodrobinhood.com
U.S. Bankusbank.com
Wells Fargowellsfargo.com

Step 3: Fetch Pages

Pick the top issuer URL and up to 3 secondary URLs (prefer thepointsguy.com, nerdwallet.com, and doctorofcredit.com when present) from the search results. Fetch in parallel.

Do not rely on snippets alone for welcome offers.

curl -sS -L "URL" | sed 's/<[^>]*>//g' | tr -s '\n' | head -200

Welcome Offer Recovery Rules

If the issuer page does not expose the welcome offer clearly in fetched text:

  1. Use the issuer page for everything else it supports.
  2. Use approved secondary sources to identify:
    • the current public offer
    • the best public offer currently visible from approved sources
  3. Prefer consistency across at least 2 approved sources for welcome-offer claims when issuer extraction fails.
  4. If the welcome offer is still unresolved after issuer + up to 3 approved secondary pages, mark it unconfirmed and say so explicitly.
  5. Do not pretend the report is complete if the welcome offer is missing.

Issuer Extraction Caveat

Some issuer pages, especially American Express, may be JS-heavy or may not expose the live offer cleanly to simple fetch tools. In those cases, use approved secondary sources for the welcome-offer section while keeping issuer pages as the primary source for fees, terms, and benefit structure.

Offer Recency & Conflict Resolution (mandatory before compiling)

Welcome offers rotate frequently and approved sources go stale at different rates. Before writing the report, resolve the live offer with these rules:

  1. Collect every offer claim found across issuer + secondary pages, with each page's update date. Do not silently prefer the first or most authoritative-sounding one.
  2. Expiration-date check: if any source states a valid-through date, compare to today. An expired offer is historical, not current.
  3. In-body offer beats tracker table: when a review page's body/detail section states an offer that differs from its own (or another page's) summary/tracker table, the in-body statement is usually the fresher one - the tracker table is often cached or written for SEO. Treat the discrepancy as a conflict to resolve, NOT a typo to ignore or a "historical variant" to file away.
  4. Freshest-dated source wins for the live offer when sources conflict, unless a fresher source explicitly contradicts it.
  5. Check the issuer newsroom for recent announcements (e.g. news.delta.com, media.chase.com) - card refreshes are announced there first and include the official offer structure and any valid-through dates.
  6. If the issuer page is JS-heavy (Amex commonly fails to expose offer text), the issuer's newsroom press release + 2 approved secondary sources count as issuer-backed verification.
  7. Never label a report "confirmed" when sources conflict on the welcome offer - mark it conflicting in Confidence Notes and state which source you treated as live and why.

Strikethrough / Refresh Offer Pitfall

Issuer pages may expose hero offer text in DOM order that is visually misleading, e.g. Earn 75,000 strikethrough 100,000 points. Do not infer the active offer from text order alone. When fetched text includes strikethrough, crossed-out amounts, or otherwise ambiguous offer rendering, verify the live page visually with browser/screenshot tools if available, or with at least two approved secondary sources that explicitly state the active offer. In the report, note which amount is active and which is struck through.

Step 4: Best Public Offer Search

After the first fetch pass is complete, run a second search for the best currently available public offer. Use WebSearch by default, or Brave if the key is available.

Do not run it immediately after the first search. Follow the pacing rule above.

curl -sS "https://api.search.brave.com/res/v1/web/search?q=CARD+NAME+best+public+offer&count=10" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Look for elevated offers via CardMatch, incognito, referral links, or specific application URLs. Include the best available public offer in the Welcome Offer section, even if it matches the standard offer.

Step 5: Historical Offers Search

After another short delay, run a third search for past notable offers. Use WebSearch by default, or Brave if the key is available.

Do not burst this search immediately after the best-offer search. Follow the pacing rule above.

curl -sS "https://api.search.brave.com/res/v1/web/search?q=CARD+NAME+historical+welcome+offers&count=10" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

If results are found, include a compact table of notable past offers with approximate date ranges and amounts in the Welcome Offer section.

If Brave rate-limits this step even after pacing and one retry, continue without historical data and say so in ## πŸ“‹ Confidence Notes. If Brave is unavailable, use WebSearch + WebFetch.

Step 6: Required Output Sections

Return compact markdown with these sections in order:

## πŸ’° Fees

Annual fee, authorized user fee, foreign transaction fee, balance transfer fee, cash advance fee, late fee.

## 🎁 Welcome Offer

Current public offer, best available public offer (if elevated), spend requirement, qualification window, eligibility restrictions, lifetime/family language.

Rules:

  • This section is required.
  • If issuer extraction fails, use approved secondary sources.
  • If the exact live offer still cannot be verified, explicitly say: Could not verify the exact live welcome offer after checking issuer and approved secondary sources.
  • Include a historical offers table only when historical data is actually available.

## πŸ“ˆ Earning Rates

Base rate, bonus categories with multipliers, caps, point currency.

## πŸ”„ Redemption

Transfer partners summary, portal options, cash-out rates, minimum redemption.

## 🏷️ Credits

Statement credits, cash-back rebates, and complimentary subscriptions with concrete dollar values only. Each credit with amount, cadence, trigger, and restrictions. Do NOT include enhanced earning rates (e.g., "5x on Lyft"), bonus point multipliers, or anniversary point bonuses - those go in Earning Rates.

## ✈️ Travel Benefits

Lounge access, hotel status, rental car benefits, travel credits, companion fares.

## πŸ›‘οΈ Protections

Purchase protection, extended warranty, return protection, cell phone protection, fraud protections.

## βš™οΈ Account Mechanics

Virtual cards, authorized user handling, app capabilities, autopay notes.

## βœ… Eligibility

Issuer family rules, known restriction language (e.g., Chase 5/24, Amex lifetime language).

## 🧭 Strategy

Downgrade paths, no-fee fallback, ecosystem role, keeper value after year one.

## πŸ‘€ Who Is This Card For?

Describe the ideal cardholder profile (spending habits, travel frequency, lifestyle), who benefits most from this card's specific strengths, and who should look elsewhere and why.

## πŸƒ Similar Cards

4-6 competing cards with annual fee and a one-line summary of why each is comparable.

## πŸ“‹ Confidence Notes

Flag any uncertain, unconfirmed, or conflicting claims.

## πŸ”— Sources

Numbered list of URLs fetched, as markdown hyperlinks with short "Site - Topic" labels.

Output Rules

  • Use one emoji per section heading.
  • When listing credits, fees, or any monetary amounts, sort from highest to lowest dollar value.
  • Use numbered lists for list-heavy sections.
  • Keep content to condensed facts - no prose padding.
  • Omit the Card Identity section when the match is confident.
  • Do not include YAML blocks in user-facing output.
  • End every report with a ## πŸ”— Sources section listing each URL fetched during research as a markdown hyperlink with a short "Site - Topic" label, e.g. [Chase - Sapphire Preferred](https://...).
  • Do not show a "Why It Matters" section.
  • If the welcome offer is unresolved, say that plainly in both ## 🎁 Welcome Offer and ## πŸ“‹ Confidence Notes.
  • Do not silently downgrade to an incomplete report.

Confidence Definitions

  • confirmed: supported by issuer terms or multiple approved sources without disagreement
  • unconfirmed: plausible but not fully resolved from approved sources
  • conflicting: approved sources disagree on a material fact

Every report must include a ## πŸ“‹ Confidence Notes section. Keep notes short and tied to concrete uncertainties.

Practical Retrieval Strategy

Reference notes:

  • references/chase-sapphire-preferred-2026-refresh.md - example of a JS/visual strikethrough welcome-offer ambiguity and how to resolve conflicting secondary sources.
  • references/delta-reserve-2026-offer-staleness.md - example of offer staleness + anchoring failure (tracker table beating the fresher in-body offer). Read this when a report's welcome offer could be stale.

Use this order of operations:

  1. Resolve the exact card. Note today's date.
  2. Run the main search using all three query shapes (generic, offer-structure, freshness-targeted).
  3. Fetch the issuer page.
  4. Fetch up to 3 approved secondary pages, preferring the freshest-dated and any DoC "live/expired" roundup posts.
  5. Fetch the issuer newsroom announcement if one exists for this card family.
  6. Wait briefly.
  7. Run the best-public-offer search.
  8. Wait briefly.
  9. Run the historical-offers search.
  10. Resolve the welcome offer via the Offer Recency & Conflict Resolution rules - check every offer for a valid-through date, let the freshest in-body statement win over tracker tables, and never rationalize away a conflicting offer as historical without a newer source confirming it.
  11. Compile the report with confidence notes for anything rate-limited, expired, or unresolved.

This skill should optimize for accurate current answer first, while preserving best-offer and historical-offer coverage through sane pacing rather than bursty search behavior.

Top skills in this category