[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M737Q36NZZGZFDTHT6K741GP":3,"skill-same:01M737Q36NZZGZFDTHT6K741GP":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":45,"install":46,"resources":59},"01M737Q36NZZGZFDTHT6K741GP","stripe-link-cli",null,"Agent payments via Stripe Link — cards, SPT, approvals.","ashneil12\u002Fvanilla-hermes-agent-canary","ashneil12","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49880658?v=4","01M7378BQ9W161EPENEWBYAQNN","01M7378BRDJG8SFS93FG4V6BWY",1,"MIT","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fpayments\u002Fstripe-link-cli\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: stripe-link-cli\ndescription: Agent payments via Stripe Link — cards, SPT, approvals.\nversion: 0.1.0\nauthor: Teknium (teknium1), Hermes Agent\nlicense: MIT\nplatforms: [linux, macos]\nmetadata:\n  hermes:\n    tags: [Payments, Stripe, Link, Checkout, MPP]\n    related_skills: [mpp-agent, stripe-projects]\n---\n\n# Stripe Link CLI Skill\n\nWraps [@stripe\u002Flink-cli](https:\u002F\u002Fgithub.com\u002Fstripe\u002Flink-cli) so Hermes can complete purchases on the user's behalf using one-time-use virtual cards or Shared Payment Tokens (SPT). Every spend is gated by an in-app approval in the Link mobile\u002Fweb app — Hermes cannot self-approve.\n\nUS-only at the moment (Link account requirement). Windows is not supported by the upstream CLI — this skill is gated `[linux, macos]`.\n\n## When to Use\n\nTrigger phrases:\n\n- \"buy X\", \"pay for X\", \"make a purchase\", \"complete checkout\"\n- \"get me a card\", \"I need a payment method\"\n- \"log in to Link\", \"connect my Link wallet\"\n- HTTP 402 response from a merchant API with `www-authenticate: ... method=\"stripe\"`\n\nIf the user wants a paid API call (HTTP 402, no checkout form), the `card` path is wrong — use SPT via this same skill, or hand off to the `mpp-agent` skill.\n\n## Prerequisites\n\n- Node.js 20+ available on `PATH` (`node --version`)\n- US-based (Link account requirement)\n\nThe Link account, payment method, and spend-approval app do NOT need to be set up before Hermes attempts to pay — the CLI walks the user through them on first run:\n\n- A Link account at https:\u002F\u002Fapp.link.com — created\u002Flinked during first `link-cli` auth\n- At least one payment method — added during first run at https:\u002F\u002Fapp.link.com\u002Fwallet\n- The Link mobile\u002Fweb app — opened to approve the first spend request when it's made\n\nNo env vars required — auth state is stored locally by the CLI under its own config directory.\n\n## Install\n\nInstall once, globally:\n\n```\nnpm install -g @stripe\u002Flink-cli\n```\n\nOr invoke ad-hoc via `npx @stripe\u002Flink-cli`. The skill below uses the installed `link-cli` form.\n\n## How to Run\n\nAll commands run through the `terminal` tool. The CLI auto-detects non-TTY callers and emits compact `toon` output by default — fine for the model. Pass `--format json` if a step needs structured fields.\n\nDiscover commands: `link-cli --llms-full`.\nGet a command's schema before invoking: `link-cli \u003Ccommand> --schema`.\n\n## Procedure\n\n### 1. Check \u002F establish auth\n\n```\nlink-cli auth status\n```\n\nIf not authenticated, log in with a clear client name (this label shows in the user's Link app):\n\n```\nlink-cli auth login --client-name \"Hermes\" --interval 5 --timeout 300\n```\n\nThe `--interval`\u002F`--timeout` form polls inline so the agent doesn't need to manage a `_next` step. Print the verification URL + phrase to the user and wait for the CLI to return.\n\n**Do not proceed past this step until `auth status` confirms login.**\n\n### 2. Evaluate the merchant before creating a spend request\n\nDecide the credential type:\n\n| Merchant surface | `--credential-type` |\n|---|---|\n| Standard web checkout form \u002F Stripe Elements | `card` (default) |\n| Returns HTTP 402 with `method=\"stripe\"` in `www-authenticate` | `shared_payment_token` |\n| Returns HTTP 402 without `method=\"stripe\"` | unsupported — stop |\n\nFor 402 responses, do NOT decode the challenge manually. Pass the raw header:\n\n```\nlink-cli mpp decode --challenge '\u003Cfull WWW-Authenticate header>'\n```\n\nThis validates the challenge and extracts the network ID + decoded request body.\n\n### 3. List payment methods + shipping\n\n```\nlink-cli payment-methods list\nlink-cli shipping-address list\n```\n\nUse the first entry unless the user specifies otherwise. The `id` from `payment-methods list` is the `--payment-method-id` in the next step.\n\n### 4. Create the spend request\n\nConfirm the final total with the user before issuing this command. Amounts are in cents.\n\n```\nlink-cli spend-request create \\\n  --payment-method-id \u003Cpm_id> \\\n  --merchant-name \"\u003Cname>\" \\\n  --merchant-url \"\u003Curl>\" \\\n  --context \"\u003Cone sentence: what is being purchased and why>\" \\\n  --amount \u003Ccents> \\\n  --line-item \"name:\u003Citem>,unit_amount:\u003Ccents>,quantity:1\" \\\n  --total \"type:total,display_text:Total,amount:\u003Ccents>\" \\\n  --request-approval\n```\n\nFor MPP merchants add `--credential-type shared_payment_token`.\n\n`--request-approval` pings the user's Link app and polls until they approve or deny. The CLI exits non-zero on deny \u002F timeout.\n\n### 5. Retrieve the credential — SECURELY\n\n**Do not print card details to stdout.** Use `--output-file` so the PAN never enters the agent's transcript or logs:\n\n```\nlink-cli spend-request retrieve \u003Clsrq_id> \\\n  --include card \\\n  --output-file ~\u002F.hermes\u002Fcache\u002Fscratch\u002Flink-card.json \\\n  --format json\n```\n\nThe file is written with `0600` perms; stdout shows only redacted fields (brand, last4, expiry) plus a `card_output_file` path.\n\n### 6. Use the credential\n\n- For web checkout: hand the file path to the user, OR pass it to a browser-driving tool that fills the form directly from disk. Never `read_file` or `cat` the card file into the agent's reasoning context.\n- For MPP merchants:\n\n  ```\n  link-cli mpp pay \u003Cmerchant-url> \\\n    --spend-request-id \u003Clsrq_id> \\\n    --method POST \\\n    --data '\u003Cjson body>'\n  ```\n\n### 7. Clean up\n\nDelete the card file as soon as the purchase is done:\n\n```\nrm -f ~\u002F.hermes\u002Fcache\u002Fscratch\u002Flink-card.json\n```\n\n## Optional: run as an MCP server instead\n\n`@stripe\u002Flink-cli --mcp` exposes the same commands as MCP tools over stdio. To register it with Hermes' native MCP:\n\n```\nhermes mcp add stripe-link --command \"npx\" --args \"@stripe\u002Flink-cli --mcp\"\n```\n\nThen `hermes mcp list` should show `stripe-link`. The same approval rules apply — MCP doesn't bypass the Link app approval step.\n\n## Pitfalls\n\n- **US-only.** Outside the US, `auth login` will fail. Tell the user, don't keep retrying.\n- **Card PAN must never enter agent context.** Use `--output-file` every time. If you've already retrieved without it, immediately `link-cli auth logout` is not enough — the card is one-time-use but rotate hygiene matters.\n- **`--request-approval` blocks until the user acts.** If the user is asleep, the CLI will hit its timeout. Set expectations.\n- **Multi-step `_next` commands.** Some commands return `_next.command` that must be executed to continue. When in doubt, prefer the inline-polling flags (`--interval`\u002F`--timeout`).\n- **Output format defaults to `toon`** in non-TTY mode. Fine for prose, but if a downstream step needs to parse a specific field, pass `--format json`.\n- **Don't default to `card`.** The merchant-evaluation step (Section 2) exists because picking the wrong credential type fails the purchase silently or leaks more data than needed.\n\n## Verification\n\n```\nlink-cli --version && link-cli auth status\n```\n\nExit code 0 means installed and logged in.\n","# Stripe Link CLI Skill\n\nWraps [@stripe\u002Flink-cli](https:\u002F\u002Fgithub.com\u002Fstripe\u002Flink-cli) so Hermes can complete purchases on the user's behalf using one-time-use virtual cards or Shared Payment Tokens (SPT). Every spend is gated by an in-app approval in the Link mobile\u002Fweb app — Hermes cannot self-approve.\n\nUS-only at the moment (Link account requirement). Windows is not supported by the upstream CLI — this skill is gated `[linux, macos]`.\n\n## When to Use\n\nTrigger phrases:\n\n- \"buy X\", \"pay for X\", \"make a purchase\", \"complete checkout\"\n- \"get me a card\", \"I need a payment method\"\n- \"log in to Link\", \"connect my Link wallet\"\n- HTTP 402 response from a merchant API with `www-authenticate: ... method=\"stripe\"`\n\nIf the user wants a paid API call (HTTP 402, no checkout form), the `card` path is wrong — use SPT via this same skill, or hand off to the `mpp-agent` skill.\n\n## Prerequisites\n\n- Node.js 20+ available on `PATH` (`node --version`)\n- US-based (Link account requirement)\n\nThe Link account, payment method, and spend-approval app do NOT need to be set up before Hermes attempts to pay — the CLI walks the user through them on first run:\n\n- A Link account at https:\u002F\u002Fapp.link.com — created\u002Flinked during first `link-cli` auth\n- At least one payment method — added during first run at https:\u002F\u002Fapp.link.com\u002Fwallet\n- The Link mobile\u002Fweb app — opened to approve the first spend request when it's made\n\nNo env vars required — auth state is stored locally by the CLI under its own config directory.\n\n## Install\n\nInstall once, globally:\n\n```\nnpm install -g @stripe\u002Flink-cli\n```\n\nOr invoke ad-hoc via `npx @stripe\u002Flink-cli`. The skill below uses the installed `link-cli` form.\n\n## How to Run\n\nAll commands run through the `terminal` tool. The CLI auto-detects non-TTY callers and emits compact `toon` output by default — fine for the model. Pass `--format json` if a step needs structured fields.\n\nDiscover commands: `link-cli --llms-full`.\nGet a command's schema before invoking: `link-cli \u003Ccommand> --schema`.\n\n## Procedure\n\n### 1. Check \u002F establish auth\n\n```\nlink-cli auth status\n```\n\nIf not authenticated, log in with a clear client name (this label shows in the user's Link app):\n\n```\nlink-cli auth login --client-name \"Hermes\" --interval 5 --timeout 300\n```\n\nThe `--interval`\u002F`--timeout` form polls inline so the agent doesn't need to manage a `_next` step. Print the verification URL + phrase to the user and wait for the CLI to return.\n\n**Do not proceed past this step until `auth status` confirms login.**\n\n### 2. Evaluate the merchant before creating a spend request\n\nDecide the credential type:\n\n| Merchant surface | `--credential-type` |\n|---|---|\n| Standard web checkout form \u002F Stripe Elements | `card` (default) |\n| Returns HTTP 402 with `method=\"stripe\"` in `www-authenticate` | `shared_payment_token` |\n| Returns HTTP 402 without `method=\"stripe\"` | unsupported — stop |\n\nFor 402 responses, do NOT decode the challenge manually. Pass the raw header:\n\n```\nlink-cli mpp decode --challenge '\u003Cfull WWW-Authenticate header>'\n```\n\nThis validates the challenge and extracts the network ID + decoded request body.\n\n### 3. List payment methods + shipping\n\n```\nlink-cli payment-methods list\nlink-cli shipping-address list\n```\n\nUse the first entry unless the user specifies otherwise. The `id` from `payment-methods list` is the `--payment-method-id` in the next step.\n\n### 4. Create the spend request\n\nConfirm the final total with the user before issuing this command. Amounts are in cents.\n\n```\nlink-cli spend-request create \\\n  --payment-method-id \u003Cpm_id> \\\n  --merchant-name \"\u003Cname>\" \\\n  --merchant-url \"\u003Curl>\" \\\n  --context \"\u003Cone sentence: what is being purchased and why>\" \\\n  --amount \u003Ccents> \\\n  --line-item \"name:\u003Citem>,unit_amount:\u003Ccents>,quantity:1\" \\\n  --total \"type:total,display_text:Total,amount:\u003Ccents>\" \\\n  --request-approval\n```\n\nFor MPP merchants add `--credential-type shared_payment_token`.\n\n`--request-approval` pings the user's Link app and polls until they approve or deny. The CLI exits non-zero on deny \u002F timeout.\n\n### 5. Retrieve the credential — SECURELY\n\n**Do not print card details to stdout.** Use `--output-file` so the PAN never enters the agent's transcript or logs:\n\n```\nlink-cli spend-request retrieve \u003Clsrq_id> \\\n  --include card \\\n  --output-file ~\u002F.hermes\u002Fcache\u002Fscratch\u002Flink-card.json \\\n  --format json\n```\n\nThe file is written with `0600` perms; stdout shows only redacted fields (brand, last4, expiry) plus a `card_output_file` path.\n\n### 6. Use the credential\n\n- For web checkout: hand the file path to the user, OR pass it to a browser-driving tool that fills the form directly from disk. Never `read_file` or `cat` the card file into the agent's reasoning context.\n- For MPP merchants:\n\n  ```\n  link-cli mpp pay \u003Cmerchant-url> \\\n    --spend-request-id \u003Clsrq_id> \\\n    --method POST \\\n    --data '\u003Cjson body>'\n  ```\n\n### 7. Clean up\n\nDelete the card file as soon as the purchase is done:\n\n```\nrm -f ~\u002F.hermes\u002Fcache\u002Fscratch\u002Flink-card.json\n```\n\n## Optional: run as an MCP server instead\n\n`@stripe\u002Flink-cli --mcp` exposes the same commands as MCP tools over stdio. To register it with Hermes' native MCP:\n\n```\nhermes mcp add stripe-link --command \"npx\" --args \"@stripe\u002Flink-cli --mcp\"\n```\n\nThen `hermes mcp list` should show `stripe-link`. The same approval rules apply — MCP doesn't bypass the Link app approval step.\n\n## Pitfalls\n\n- **US-only.** Outside the US, `auth login` will fail. Tell the user, don't keep retrying.\n- **Card PAN must never enter agent context.** Use `--output-file` every time. If you've already retrieved without it, immediately `link-cli auth logout` is not enough — the card is one-time-use but rotate hygiene matters.\n- **`--request-approval` blocks until the user acts.** If the user is asleep, the CLI will hit its timeout. Set expectations.\n- **Multi-step `_next` commands.** Some commands return `_next.command` that must be executed to continue. When in doubt, prefer the inline-polling flags (`--interval`\u002F`--timeout`).\n- **Output format defaults to `toon`** in non-TTY mode. Fine for prose, but if a downstream step needs to parse a specific field, pass `--format json`.\n- **Don't default to `card`.** The merchant-evaluation step (Section 2) exists because picking the wrong credential type fails the purchase silently or leaks more data than needed.\n\n## Verification\n\n```\nlink-cli --version && link-cli auth status\n```\n\nExit code 0 means installed and logged in.\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":36,"description":7},"Teknium (teknium1), Hermes Agent","0.1.0",{"hermes":26},{"tags":27,"related_skills":33},[28,29,30,31,32],"Payments","Stripe","Link","Checkout","MPP",[34,35],"mpp-agent","stripe-projects",[37,38],"linux","macos","main","0905b0264ce5a54908bedc9637e50251543db132","optional-skills\u002Fpayments\u002Fstripe-link-cli",0,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary","https:\u002F\u002Fgithub.com\u002Fashneil12","2026-11-04 08:25:00",{"source":8,"skillName":5,"commands":47,"prompt":57,"zipAvailable":58},[48,51,54],{"tool":49,"command":50},"npx","npx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill stripe-link-cli",{"tool":52,"command":53},"bunx","bunx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill stripe-link-cli",{"tool":55,"command":56},"pnpm","pnpm dlx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill stripe-link-cli","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fpayments\u002Fstripe-link-cli\u002FSKILL.md",true,[],[61,68,75,82,89,96],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7380YR13A23353XT9NS6EGR","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7380VZ8P60Q64J3F92D4AMY","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7380QXN6F90R0MH1M3FHRKX","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7380N4BZYT2WRRZN1N9DZ65","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M7380JAEC9ZH5DVPHHK56P97","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M7380F5MBB7FKWWV3G3TZ193","requesting-code-review","Pre-commit review: security scan, quality gates, auto-fix.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Frequesting-code-review\u002FSKILL.md",[],[]]