Credit Card Skills

Nine research skills for comparing U.S. credit cards, understanding benefits, and reviewing a wallet. Use them with an AI agent that can research current sources and follow a structured output contract.

Skills · Install · Examples · Validation

Skills

Command	Research task
`/card-full`	Full report for one card
`/card-rate`	Earning categories, caps, and exclusions
`/card-transfer`	Transfer partners and program rules
`/card-credits`	Statement credits, enrollment, and restrictions
`/card-news`	Recent changes with dated sources
`/card-compare`	Side-by-side card comparison
`/card-value`	Value estimate using stated spending and benefit assumptions
`/card-wallet`	Overlap, gaps, and earning choices across a wallet
`/card-profile-recommend`	Card options matched to a profile and its constraints

The shared contracts define source requirements, uncertainty handling, and output structure. Card terms change: results should cite current issuer or program pages and distinguish confirmed terms from assumptions. Example fixtures are format checks, not a current catalog of offers or benefits.

Install

Install into a project

Clone this repository somewhere outside the project you want to install into:

git clone https://github.com/jiahongc/credit-card-skills.git

From the destination project's root, run the installer using the path to that clone:

bash /path/to/credit-card-skills/install.sh --all

Flag	Destination, relative to the current directory
`--claude`	`.claude/skills/`
`--codex`	`.agents/skills/`
`--all`	Both directories

The installer fetches the repository and copies the card-* skill directories, including shared support files. It can update existing copies with the same names. Without a flag, it detects existing agent directories.

Other runtimes

Source packages are also available in clawhub/. Use the package appropriate to your runtime; installing prompt files alone does not provide web-search tools or provider credentials.

Research setup

Use an agent with live web access. For workflows that use Brave Search, copy the environment template and supply your own key:

# From this repository's root
cp .env.example .env

Set BRAVE_API_KEY in your runtime environment. A local .env file is useful only when the chosen runtime loads it; never commit credentials.

Examples

/card-full Chase Sapphire Preferred
/card-rate Capital One Venture X
/card-transfer American Express Gold
/card-credits Chase Sapphire Preferred
/card-news Capital One Venture X
/card-compare Chase Sapphire Preferred vs Capital One Venture X
/card-value Chase Sapphire Preferred
/card-wallet Chase Sapphire Preferred + American Express Gold
/card-profile-recommend

For value and recommendation workflows, include your spending, existing cards, travel habits, and which benefits you will actually use. Review the assumptions in the output before acting on it.

See sample-outputs.md and tests/fixtures/ for output examples. Their numerical details are snapshots and may be outdated.

Repository guide

Path	Purpose
`.claude/skills/`	Installable skill definitions and shared validators
`.agents/`	Agent-specific integration files
`.claude-plugin/`	Plugin metadata
`clawhub/`	Skill packages for ClawHub-style runtimes
`tests/fixtures/`	Golden outputs and ambiguity, conflict, missing-data, and recency cases
`install.sh`	Project-local installer

Validation

From the repository root, with Python 3 and Bash installed:

bash tests/run_all.sh

This runs fixture validation, contract composition checks, and cross-fixture consistency checks. It does not establish that card terms or example offers remain current.

License

The project declares MIT in its existing documentation. A standalone license file is not currently included.