The skill
How the Sangria skill works, and where the full reference lives.
Sangria ships a CLI plus one Claude Code skill. The setup skill at getsangria.com/skill installs the sangria CLI globally and installs the skill into ~/.claude/skills/ — see CLI.
The skill is documented in full in its own SKILL.md served from getsangria.com. That file is the source of truth your agent actually loads at runtime — this page is orientation. The skill tells the agent when and why to use Sangria; the CLI handles auth and API calls.
sangria
Finds products and locks in a price with sangria discover, then commits one approved match with sangria buy. Discovery returns a discovery_id plus up to 5 matches, each with a sku, the item price before tax, an estimated tax, and the estimated tax-inclusive total your credits get charged at buy. No money moves during discovery.
Triggers whenever you ask to buy, find, order, or get something. The skill asks clarifying questions when the request is vague, shows matches and prices, and only buys after approval.
Buying charges your credit balance, places the order with the merchant, and returns the merchant's response verbatim. The debit lands only after the merchant confirms, so a failed order costs you nothing.
It's idempotent on {discovery_id, sku} — running the same buy command never double-charges, so it doubles as the reconciliation path if a response is lost. A merchant decline comes back with status: "failed" and costs nothing.
Reference: SKILL.md