Agent skill

Amazon Returns Recovery

by JasonColapietro in JasonColapietro/suede-creator-skills

Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions.

MITAuto-check passed

Install Amazon Returns Recovery

skills CLI
$ npx skills add JasonColapietro/suede-creator-skills --skill amazon-returns-recovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JasonColapietro/suede-creator-skills amazon-returns-recovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JasonColapietro/suede-creator-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/amazon-returns-recovery .claude/skills/amazon-returns-recovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
amazon-returns-recovery
GitHub stars
127
Token cost
~2.8k tokens
SKILL.md length
1,498 words
Files
5 (incl. references)
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions.

  • Works in 3 steps: Confirm with the user → Dispute or cancel (one item at a time,… → Report
  • The user mentions a restocking fee
  • SKILL.md covers Why this exists, Prerequisites, Phase 1a: Order/return… and Phase 1b: Digital subscription…, plus 5 more sections
  • Reaches amazon.com and primevideo.com

What it does

Amazon Returns Recovery is an agent skill from JasonColapietro/suede-creator-skills. Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions. Use when the user mentions a restocking fee, a short or denied Amazon refund, or a forgotten Prime Video Channel, Audible, Kindle Unlimited, or Prime charge, or asks whether Amazon still owes or bills them. Read-only discovery; no chat, cancellation, or dispute without the account owner's per-item confirmation, and never a promise of recovery. Requires an authenticated Claude in Chrome…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `CARD.md`, `agents/openai.yaml` and `references/dispute-chat-flow.md`).

The repository describes itself as: Open-source AI skills for SEO, AI search visibility, conversion copy, marketing strategy, and business operations. Reusable workflows for Claude Code and Codex, plus code review… The licence is MIT.

When your agent uses it

  • The user mentions a restocking fee
  • Denied Amazon refund
  • A forgotten Prime Video Channel
  • Kindle Unlimited

Example prompts

  • “/amazon-returns-recovery”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Confirm with the user
  2. Dispute or cancel (one item at a time, only after confirmation)
  3. Report

What it can do on your machine

Read from SKILL.md and the folder at commit e5f94d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • amazon.com
    • primevideo.com
    • audible.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Amazon Returns Recovery loads about 2.8k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 175 tokens; SKILL.md has 1,498 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~175
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JasonColapietro/suede-creator-skills at commit e5f94d7, republished under its MIT licence (© JasonColapietro). 1,498 words, ~2,808 tokens.

Download SKILL.mdSave it as .claude/skills/amazon-returns-recovery/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
amazon-returns-recovery
description
Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions. Use when the user mentions a restocking fee, a short or denied Amazon refund, or a forgotten Prime Video Channel, Audible, Kindle Unlimited, or Prime charge, or asks whether Amazon still owes or bills them. Read-only discovery; no chat, cancellation, or dispute without the account owner's per-item confirmation, and never a promise of recovery. Requires an authenticated Claude in Chrome session. NOT FOR: bank chargebacks, marketplace A-to-z seller claims, price-protection claims, or subscriptions billed outside Amazon (use subscription-recovery).
metadata.version
1.0.0

Amazon Returns Recovery

Iron Law:

Nothing is disputed, canceled, or sent without the account owner's per-item
confirmation. Discovery is read-only; every action phase is gated.

Why this exists

  1. Money like this doesn't announce itself. Restocking fees, short refunds, and forgotten subscription charges sit unannounced in order history unless something checks.
  2. Overturning an already-denied refund after the return window closed is the realistic ceiling of a well-reasoned exception ask, so ask for more than a waiver when the facts support it.

Read references/example-cases.md before drafting a dispute: three synthetic scenarios for practicing the workflow, not evidence of customer outcomes.

Prerequisites

  • Claude in Chrome browser extension connected to the browser, and the user already signed into the target Amazon account. If mcp__claude-in-chrome__* tools aren't loaded yet, fetch them via ToolSearch first (see the extension's own MCP instructions for the batch-load query).
  • This runs against a real account. If the account is shared (family members with separate shipping addresses on the same login), be ready to see orders that aren't the user's, flag those, don't just fold them into the same batch without asking.

Phase 1a: Order/return discovery (read-only, no side effects)

Goal: find every completed return where Amazon deducted a restocking fee, without touching anything.

  1. Search order history broadly by category keyword, not just exact terms, Amazon's your-orders/search matches loosely, so one keyword (e.g. "razor") surfaces adjacent items (shavers, trimmers) too. Restocking fees concentrate on higher-value electronics/appliances, so prioritize checking those over consumables or clothing.
    • https://www.amazon.com/your-orders/search/ref=ppx_yo2ov_dt_b_search?opt=ab&search=<keyword>
    • Paginate through all result pages: don't stop at page 1. Older orders (a year+ back) still show up here even though they've long since dropped off Your Returns.
  2. For faster coverage of recent activity, also check https://www.amazon.com/your-returns, but note it only shows roughly the last 3 months, so it's a supplement to the search sweep, not a replacement for it.
  3. For each order that shows "Return complete" / "Refund Complete" / "Refund issued", open its detail page: https://www.amazon.com/your-orders/order-details?orderID=<orderID> Find the Refund Total line: it has a small chevron that expands to an itemized breakdown (Item(s) refund / Tax refund / Restocking fee / Refund Total). Click it. Orders with no fee just show item + tax = refund total; orders with a fee show the deduction explicitly.
  4. Record every hit: order #, item name, item price, restocking fee amount, who it shipped to, and whether it was sold by Amazon.com directly or a third-party seller (first-party listings are the strongest cases, Amazon's own chat agents can waive those without looping in a marketplace seller).
  5. Don't try to make this exhaustive on the first pass if the account has a long history, report what's found so far and note that more may be scattered across older years if the user wants a deeper sweep.

Stop here: Iron Law. Discovery ends; nothing is opened or disputed yet.

Phase 1b: Digital subscription audit (read-only, no side effects)

Unvalidated click-path: the exact URLs below are the best-known entry points as of this writing, not yet confirmed live like the Phase 1a flow. If a URL 404s or redirects somewhere unexpected, navigate from the account menu instead (Amazon moves these pages periodically) and note the working path back into this file once confirmed.

Goal: find every recurring digital subscription billed through the Amazon account: Prime Video Channels, Audible, Kindle Unlimited, Prime itself, and flag ones that look forgotten, unused, or worth reconsidering. This is a different shape of "money Amazon is quietly taking" than restocking fees: it's ongoing, not a one-time deduction, so the fix is usually "cancel it" rather than "waive it," with a refund ask reserved for genuinely forgotten charges.

  1. Prime Video Channels (this is how Britbox, Starz, AMC+, Paramount+, Shudder, MGM+, etc. actually bill: they're not separate Amazon relationships, they're add-on channels on top of Prime Video): https://www.primevideo.com/settings/channels, lists every active channel subscription, price, and next billing date. If that redirects, go to Prime Video → Account & Settings (top right) → Channels.
  2. Audible membership: https://www.audible.com/account/membership-overview: same Amazon login, separate billing page. Shows plan tier, price, next charge date, and credit balance (unused credits are themselves worth flagging: they don't expire immediately but do eventually).
  3. Kindle Unlimited: https://www.amazon.com/kindle-dbs/subscribe/kindle_unlimited or via Account → Digital Services and Devices → Kindle Unlimited.
  4. Prime membership itself: https://www.amazon.com/manageprime, for cases where the user isn't using Prime shipping/video/music benefits and it's worth flagging (this one is more consequential to cancel than a $9 channel add-on, so treat it as report-only unless the user specifically asks about it).
  5. For each subscription found, record: name, monthly/annual price, next billing date, and, if the page shows it, last-used or last-watched date. If usage data isn't visible on the billing page, ask the user directly whether they still use it rather than guessing.
  6. Build the list only: Iron Law.

Phase 2: Confirm with the user

Report the findings as a plain list: for fees, item / order # / fee amount / who it shipped to / first-party or third-party; for subscriptions, name / price / billing cadence / next charge date / whether it looks used or forgotten. Ask which ones to pursue and what outcome they want for each (waive a fee, dispute a charge, cancel a subscription, or cancel and ask for the last charge back). Some fees are legitimate (e.g. an opened-item policy the seller disclosed at return time) and some subscriptions may turn out to still be wanted: don't assume every finding is worth acting on, and say so if one looks earned or intentional rather than a mistake.

Show full SKILL.md (611 more words)Show less

Phase 3: Dispute or cancel (one item at a time, only after confirmation)

For fee/refund disputes, drive Amazon's live chat to request a waiver. The exact click-path, a critical popup-window workaround, and the escalation flow to a human associate are documented in references/dispute-chat-flow.md, read that file before starting this phase, since Amazon's chat UI has a specific gotcha (it opens in a popup window Claude in Chrome's tab tracking can't see) that will silently strand the flow if skipped. The same chat flow and associate-facing script apply whether the ask is "waive this restocking fee" or "cancel this channel and refund the last charge", only the specifics of the ask change.

For subscription cancellations, note the two distinct asks are not equally strong:

  • "Cancel this subscription" is unconditional: the user is entitled to cancel anytime, no negotiation needed. This can usually be done directly on the subscription's own settings page (the URLs in Phase 1b) without needing chat at all, try that first, it's faster than a chat dispute.
  • "Refund the last charge because I forgot to cancel / wasn't using it" is a goodwill ask, same as a restocking-fee waiver, reasonable to make once, under the truthfulness and single-counter rules in Boundaries.

Two chat mechanics, beyond those Boundaries rules:

  • When offered a refund method, default to original payment method unless the user said otherwise.
  • Confirm the exact refund amount and stated timeline, or the exact cancellation effective date, before ending the chat.

Phase 4: Report

After each dispute or cancellation resolves (or if the associate declines), tell the user: amount, refund method, stated ETA or effective date, and associate name if given. If several items were pursued in one session, summarize as a running total across fees, refunds, and subscriptions canceled (report subscription savings as "$X/month going forward" separately from one-time dollars recovered: they're not the same kind of money).

Evidence rules: a promise is not money:

  • Quote the associate's confirmation verbatim from the transcript, not paraphrased. No captured confirmation line means no amount is reported.
  • Label every unverified amount promised, never "recovered." Only a posted line item counts toward a recovered total.
  • Set the readback as a follow-up: the stated ETA is typically 3-5 business days, so it cannot resolve in-session. After that date, reopen the order detail page, expand the Refund Total chevron per Phase 1a step 3, and compare the breakdown against the promised amount. Tell the user the date to check and the number to look for.
  • If the readback shows the waiver never posted, reopen it as a new case with the transcript quote as evidence.

Boundaries

  • Keep account records, personal reasons, household details, and support transcripts in the user's private session. Never append them to skill files, public examples, or repository notes.

  • Nothing is disputed, canceled, or sent without the account owner's per-item confirmation; approval for one item never transfers to another. Phases 1a and 1b are read-only.

  • On a shared login, flag orders belonging to other people instead of folding them into the batch.

  • State only true facts to an associate: order number or subscription name, item, price, fee amount. Never invent a prior contact attempt, a return reason, or a cancellation reason.

  • Make a goodwill ask once. Do not push past a single polite counter if declined.

  • Never promise recovery, and never report a promised amount as recovered money.

  • Price-protection refunds are out of scope and unvalidated: do not attempt one without discussing it with the user first.

Routing

  • Subscriptions billed outside Amazon (by the provider, Apple, or Google rather than the Amazon account) -> use subscription-recovery.
  • Bank chargebacks, marketplace A-to-z seller claims, and price-protection claims are out of scope for this skill entirely.

© JasonColapietro, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/amazon-returns-recovery of JasonColapietro/suede-creator-skills.

  • SKILL.md
  • CARD.md
  • agents/openai.yaml
  • references/dispute-chat-flow.md
  • references/example-cases.md

Open the folder on GitHubat commit e5f94d7

Compare with similar skills

Amazon Returns Recovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Amazon Returns Recovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Amazon Returns Recovery this skillJasonColapietro/suede-creator-skills127—~2.8kAutomated safety check: PassMIT
Backup Recoverysickn33/agentic-awesome-skills47k2 repos~3kAutomated safety check: WarnMIT
Disaster Recoverysickn33/agentic-awesome-skills47k2 repos~3kAutomated safety check: PassMIT
Amazon Return Reductionnexscope-ai/Amazon-Skills744—~454Automated safety check: PassMIT
Affiliate Disclosurethedaviddias/Front-End-Checklist74k—~444Automated safety check: PassMIT
Amazonvellum-ai/vellum-assistant1.4k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Backup Recovery

    sickn33/agentic-awesome-skills

    Implement backup and recovery strategies. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3k tokens
    DevOps & CloudAuto-check: warnings
  • Disaster Recovery

    sickn33/agentic-awesome-skills

    Implement disaster recovery strategies and runbooks. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3k tokens
    DevOps & CloudAuto-check passed
  • Amazon Return Reduction

    nexscope-ai/Amazon-Skills

    Return rate reduction — root cause analysis, listing accuracy, packaging improvements, size guides

    744 GitHub stars~454 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Affiliate Disclosure

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Provide clear affiliate disclosures.

    74k GitHub stars~444 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Amazon

    vellum-ai/vellum-assistant

    Shop on Amazon and Amazon Fresh through your browser. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Testing Ransomware Recovery Procedures

    mukul975/Anthropic-Cybersecurity-Skills

    Tests and validates ransomware recovery procedures - backup restore operations (e.g.

    34k GitHub stars~1.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from JasonColapietro/suede-creator-skills

All 78 skills in this repo
  • Suede Release Linter

    JasonColapietro/suede-creator-skills

    Lints a local music or media release folder and scores its readiness, flagging missing files, weak metadata, artwork and stem problems, split gaps and rights blockers.

    127 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes
  • Creator Rights Passport

    JasonColapietro/suede-creator-skills

    Turns messy creator materials into an offline rights-and-provenance transfer package: hashed asset inventory, intake manifest, credits, license notes and a missing-information report.

    127 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check: notes
  • Suede Clip to Guide

    JasonColapietro/suede-creator-skills

    Turns a video clip, interview moment or transcript into a package that bridges viewers to a long-form guide, with rights, claim and approval gates along the way.

    127 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • Suede MCP Release QA

    JasonColapietro/suede-creator-skills

    Checks a Suede AI MCP server release against a live process: the full JSON-RPC lifecycle, schemas, annotations, malformed input, catalog agreement and install docs.

    127 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Android App Factory

    JasonColapietro/suede-creator-skills

    Takes a native Android app from product idea to Google Play release, covering Compose architecture, policy checks, privacy, billing, testing, signing and rollout.

    127 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Suede Ad Creative

    JasonColapietro/suede-creator-skills

    Suede-owned paid-media creative system for hooks, headlines, primary text, static and motion concepts, platform specs, review pages, and test-ready variant batches.

    127 GitHub stars~5k tokensUpdated yesterday
    Auto-check passed

Questions about Amazon Returns Recovery

What does Amazon Returns Recovery do?

Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions. Amazon Returns Recovery is an agent skill from JasonColapietro/suede-creator-skills. Suede-affiliated Amazon money-recovery audit for restocking fees, short or denied refunds, and Amazon-billed subscriptions.

When should I use Amazon Returns Recovery?

Amazon Returns Recovery fits situations like: the user mentions a restocking fee; denied Amazon refund; A forgotten Prime Video Channel; kindle Unlimited.

How do I install Amazon Returns Recovery in Claude Code?

Run `npx skills add JasonColapietro/suede-creator-skills --skill amazon-returns-recovery -a claude-code`. Or copy the skill folder (skills/amazon-returns-recovery in JasonColapietro/suede-creator-skills) into .claude/skills/amazon-returns-recovery in your project. Claude Code loads it when a task matches its description.

How do I install Amazon Returns Recovery in Codex?

Run `npx skills add JasonColapietro/suede-creator-skills --skill amazon-returns-recovery -a codex`. Or copy the skill folder (skills/amazon-returns-recovery in JasonColapietro/suede-creator-skills) into .agents/skills/amazon-returns-recovery in your project. Codex loads it when a task matches its description.

Can I use Amazon Returns Recovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JasonColapietro/suede-creator-skills --skill amazon-returns-recovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/amazon-returns-recovery, .gemini/skills/amazon-returns-recovery, .github/skills/amazon-returns-recovery and .opencode/skills/amazon-returns-recovery in your project.

What does Amazon Returns Recovery need to run?

SKILL.md names no scripts, command-line tools or credentials: Amazon Returns Recovery is instructions for the agent only.

Does Amazon Returns Recovery access the network?

SKILL.md names 3 domains. In commands or code: amazon.com, primevideo.com and audible.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Amazon Returns Recovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Amazon Returns Recovery use?

Amazon Returns Recovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Amazon Returns Recovery use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Amazon Returns Recovery?

Skills that share tags, products or a category with Amazon Returns Recovery: Backup Recovery (sickn33/agentic-awesome-skills, 47k stars), Disaster Recovery (sickn33/agentic-awesome-skills, 47k stars), Amazon Return Reduction (nexscope-ai/Amazon-Skills, 744 stars) and Affiliate Disclosure (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Amazon Returns Recovery?

JasonColapietro (a GitHub user) maintains it in JasonColapietro/suede-creator-skills, which has 127 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 10, 2026.

Source: JasonColapietro/suede-creator-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.