Amazon

What it does

Example prompts

• “/amazon”

Requirements

• Node.js
• Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

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

1. 1Classify workflow state
2. 2Product discovery (search)
3. 3Product detail + variant resolution (variant_select)
4. 4Add to cart + verify (cart_review)
5. 5Fresh slot validation (fresh_slot)
6. 6Checkout sanity (checkout_review)
7. 7Final submit gate (place_order)

What it can do on your machine

Read from SKILL.md and the folder at commit c92ead1. 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

  Ships 14 files in scripts/ (TypeScript, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • bun

  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

  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.

• Compatibility

  Designed for Vellum personal assistants

  From compatibility in the SKILL.md frontmatter.

Context cost

Amazon loads about 1.2k tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 422 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~15

When it runs · the whole SKILL.md, loaded when a task matches

~1.2k

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit c92ead1, republished under its MIT licence (© vellum-ai). 422 words, ~1,212 tokens.

name

amazon

description

Shop on Amazon and Amazon Fresh through your browser

compatibility

Designed for Vellum personal assistants

metadata.icon

assets/icon.svg

metadata.emoji

🛒

bun {baseDir}/scripts/amazon-intent.ts --request "<latest user request>" --checkout-reviewed <true|false> --has-cart-items <true|false>

assistant browser --session amazon navigate --url "https://www.amazon.com/s?k=<urlencoded query>"

assistant browser --session amazon --json snapshot
assistant browser --session amazon --json extract --include-links

bun {baseDir}/scripts/amazon-parse-search.ts --query "<query>" --input-json '<json payload with extracted text/links>'

bun {baseDir}/scripts/amazon-parse-product.ts --input-json '<json payload with extracted text/links>'

assistant browser --session amazon navigate --url "https://www.amazon.com/gp/cart/view.html"
assistant browser --session amazon --json snapshot
assistant browser --session amazon --json extract --include-links

bun {baseDir}/scripts/amazon-parse-cart.ts --input-json '<json payload with extracted text>'

assistant browser --session amazon --json snapshot
assistant browser --session amazon --json extract
assistant browser --session amazon screenshot --full-page --output /tmp/amazon-checkout.jpg

bun {baseDir}/scripts/amazon-checkout-sanity.ts --cart-confirmed true --input-json '<json payload with extracted text>'

{
  "phase": "search",
  "context": { "checkoutReviewed": false, "hasCartItems": false },
  "extracted": {
    "text": "...",
    "links": ["https://www.amazon.com/dp/B08XGDN3TZ"]
  },
  "userIntent": "order aa batteries"
}

© vellum-ai, 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 17 other files (scripts, assets) in skills/amazon of vellum-ai/vellum-assistant.

• SKILL.md
• README.md
• assets/icon.svg
• scripts/__fixtures__/cart-sample.txt
• scripts/__fixtures__/product-sample.txt
• scripts/__fixtures__/search-sample.txt
• scripts/__tests__/amazon-checkout-sanity.test.ts
• scripts/__tests__/amazon-intent.test.ts
• scripts/__tests__/amazon-parse-cart.test.ts
• scripts/__tests__/amazon-parse-product.test.ts
• scripts/__tests__/amazon-parse-search.test.ts
• scripts/amazon-checkout-sanity.ts
• scripts/amazon-intent.ts
• scripts/amazon-parse-cart.ts
• scripts/amazon-parse-product.ts
• scripts/amazon-parse-search.ts
• scripts/lib
• … and 1 more

Open the folder on GitHubat commit c92ead1