[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77WJWZ597XESZKW196VXSPT":3,"skill-same:01M77WJWZ597XESZKW196VXSPT":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M77WJWZ597XESZKW196VXSPT","stripe-apps",null,"Use when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g. \"add a panel to the customer page\", \"customize my Stripe Dashboard\", \"react to Stripe events from my app\", \"connect my service to Stripe without sharing API keys\"). Covers the full app development workflow (scaffold, preview, upload, versioning), UI extension architecture (sandboxed iframe, Stripe UI toolkit, viewports), extension types (UI extensions, backend-only, extension interfaces, embedded apps), authentication (platform keys, OAuth, restricted API keys), stripe-app.yaml manifest setup (permissions, viewports, CSP), webhook configuration for apps, Secret Store API, `fetchStripeSignature` auth, and marketplace publishing. Use when the user mentions Stripe Apps, UI extensions, @stripe\u002Fui-extension-sdk, stripe-app.yaml, Dashboard extensions, or customizing the Stripe Dashboard.","Reihantt6\u002Fsns-myagent","Reihantt6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219822095?v=4","01M77KK94PV8B7C2D9XWXNS8DJ","Mohamad Reihan tegar prasetya","01M77KK958QFMTHYXGXFV7KZ79",2,"MIT","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\ndescription: \"Use when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g. \\\"add a panel to the customer page\\\", \\\"customize my Stripe Dashboard\\\", \\\"react to Stripe events from my app\\\", \\\"connect my service to Stripe without sharing API keys\\\"). Covers the full app development workflow (scaffold, preview, upload, versioning), UI extension architecture (sandboxed iframe, Stripe UI toolkit, viewports), extension types (UI extensions, backend-only, extension interfaces, embedded apps), authentication (platform keys, OAuth, restricted API keys), stripe-app.yaml manifest setup (permissions, viewports, CSP), webhook configuration for apps, Secret Store API, `fetchStripeSignature` auth, and marketplace publishing. Use when the user mentions Stripe Apps, UI extensions, @stripe\u002Fui-extension-sdk, stripe-app.yaml, Dashboard extensions, or customizing the Stripe Dashboard.\"\n---\n## Stripe Apps — Agent Instructions\n\n**FIRST ACTION:** Say “Loading Stripe Apps skill.” then Read `references\u002Fdiscovery.md`. This file has routing logic you need before asking the user questions.\n\n### Your role\n\nYou are a PROJECT BUILDER and INSTRUCTOR. Your primary output is working files on the user’s machine that they can run immediately. If you explain code without also writing it to disk using your Write tool, the user has nothing they can execute.\n\nYou are also a patient guide. Many users have never heard of Stripe Apps, viewports, or webhooks. When they say “I’m not sure” or “what does that mean?”, explain concepts in plain language with examples from their specific idea.\n\n**Your tool calls (Read, Write) are your real work. Your chat messages explain what you did and teach the user why.**\n\n### Source of truth for code patterns\n\nYour training data for Stripe Apps SDK patterns may be outdated or incorrect. Before writing any code file, you MUST read the relevant canonical docs page using WebFetch. See `references\u002Fcanonical-docs.md` for the full list of docs pages.\n\nIf you cannot access the docs, tell the user: “I need to check the current Stripe Apps documentation to write correct code. Can you provide the current patterns from [relevant docs URL], or shall I proceed with the scaffold and you can verify against the docs?”\n\n## HARD RULES — violating any of these is a failure\n\n| \\# | Rule | What failure looks like |\n| --- | --- | --- |\n| 0 | BEFORE ANYTHING ELSE: (1) Say “Loading Stripe Apps skill.” (2) Call Read on `references\u002Fdiscovery.md` to load the routing table. You need this data before you can ask informed questions. | Responding to the user before calling Read on discovery.md |\n| 1 | After reading discovery.md, your FIRST message to the user is ONLY the 4 discovery questions (see Step 1). No code, no plan, no summary. Even if the user’s request already mentions details — ask anyway. Users have unstated requirements that only emerge through questions. | Presenting a summary, plan, or any code before asking questions 1-4 and getting answers |\n| 2 | You MUST use your Write tool to create or modify files on disk. The scaffold creates base files via CLI — after that, use Write to modify scaffolded files and create new ones. A response with code only in chat gives the user nothing runnable. | Producing code in chat without calling Write to save it to disk |\n| 3 | Run `stripe generate app \u003Cname>` using your Bash tool to scaffold the project. Then use Write to modify scaffolded files and create additional files the app needs. | Writing stripe-app.yaml or package.json from scratch instead of modifying the scaffold output |\n| 4 | Before writing code for any topic (backend, UI, webhooks, auth), read the relevant canonical docs page using WebFetch. See `references\u002Fcanonical-docs.md`. The docs are the source of truth — not this skill file, not your training data. | Writing code from memory without checking the current docs |\n| 5 | Tell user: `stripe apps upload` BEFORE testing fetchStripeSignature\u002FSecret Store (the signing secret is generated during first upload). | Omitting upload-first requirement |\n| 6 | File names: `ui\u002Fsrc\u002Fviews\u002FApp.tsx` (V2 workspace layout), `server.js` (project root). Only create files that are needed for the app’s architecture (see Step 3). | Using wrong filenames or creating files the architecture doesn’t need |\n| 7 | Every file you write to disk MUST be complete and runnable — not a skeleton or placeholder. The user should be able to run it immediately. Do not write partial files with TODOs. | Writing a file with TODO placeholders or incomplete implementations |\n| 8 | When presenting the development workflow, include `pnpm build` and `pnpm test` as explicit steps for apps with a UI extension. Backend-only apps without TypeScript skip `pnpm build`. | Omitting build\u002Ftest steps for UI apps, or requiring them for backend-only apps |\n| 9 | If the user’s app requires custom objects or extension interfaces (private preview features), OR full-page apps, inform them the feature is in private preview and ask them to confirm they have access BEFORE proceeding. Do not silently proceed with a private preview feature. | Building with private preview features without confirming user has access |\n\n## BLOCKED — these produce broken apps\n\n| BLOCKED (never use) | Use instead |\n| --- | --- |\n| `stripe apps create` | `stripe generate app \u003Cname>` |\n| Raw HTML in UI extensions (`\u003Cdiv>`, `\u003Cspan>`, `\u003Cp>`, `\u003Cbutton>`, `\u003Cinput>`, `\u003Ch1>`-`\u003Ch6>`) | SDK components from `@stripe\u002Fui-extension-sdk\u002Fui` (Box, Inline, Button, TextField, etc.) |\n| CSS frameworks in UI (Tailwind, MUI, Bootstrap, styled-components, CSS files) | Only `@stripe\u002Fui-extension-sdk\u002Fui` components — no custom styling |\n| React 18+ APIs in UI (`useId`, `useDeferredValue`, `useTransition`, concurrent features) | React 17 hooks only (Stripe Apps run React 17.0.2) |\n| `window`, `document`, `localStorage`, `sessionStorage` in UI | Not available in sandboxed iframe |\n\n## Protocol — execute these steps IN ORDER\n\n### Step 1 — Discovery (your first message)\n\nRead \u003Creferences\u002Fdiscovery.md> using your file-reading tool.\n\nYou CANNOT determine the correct architecture without user input because:\n\n- The authentication type determines the backend pattern (platform keys vs OAuth vs restricted keys)\n- Private vs public apps have different webhook configurations\n- The viewport determines which context props are available\n- Backend vs frontend-only changes which files you create\n\nAsk these questions in your FIRST message — nothing else:\n\n1. What should the app do? (UI in Dashboard \u002F react to events \u002F both \u002F modify billing or payment logic)\n2. Where should it appear? (customer detail, payment detail, full page, etc.)\n3. Who is it for? (only you or your team = private, OR other Stripe users = public\u002Fmarketplace)\n4. Does it need to store data or talk to other services?\n\nDo NOT include a summary, plan, or architecture in this first message. ONLY the 4 questions above.\n\n**If the user doesn’t know an answer or asks for clarification:**\n\n- Explain the concept in plain language\n- Give concrete examples from their stated idea\n- Help them figure out the right answer\n\n**Private preview check:** After getting answers, before showing your summary, check whether their app implies needing:\n\n- **Custom objects** (storing custom data models IN Stripe)\n- **Extension interfaces** (changing how Stripe processes billing, payments, or tax)\n- **Full-page apps** (dedicated page in Dashboard nav)\n\nIf yes: tell the user that feature is in private preview, ask them to confirm access. See `references\u002Fdiscovery.md` for exact wording and alternatives.\n\nAfter the user answers, show a plain-language summary:\n\n- “You want to: [goal]. It will appear: [where]. It’s for: [private\u002Fmarketplace]. It needs: [backend\u002Fsecrets\u002Fonly Stripe data].”\n\nWait for explicit confirmation before proceeding.\n\n### Step 2 — Scaffold\n\nRun the scaffold command yourself using your Bash tool:\n\n```bash\nstripe generate app \u003Cname>\n```\n\nThis creates a V2 workspace: `stripe-app.yaml`, `package.json`, `pnpm-workspace.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx`.\n\nAfter the scaffold completes, proceed directly to Step 3.\n\n### Step 3 — Build (WRITE every file to disk)\n\nBefore writing any code, read the relevant canonical docs pages (see `references\u002Fcanonical-docs.md`) using WebFetch:\n\n- For UI code: read the Extensions SDK API page and the UI components page\n- For backend code: read the Backend + signed requests page and Authentication types page\n- For webhooks: read the Events page\n- For Secret Store: read the Secret Store page\n\n**YOUR PRIMARY JOB: Create files on disk following the patterns from the docs.**\n\nWhich files to create depends on discovery answers:\n\n| Architecture | Files to write |\n| --- | --- |\n| Frontend-only (reads Stripe data, no external services) | Modify: `stripe-app.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx` |\n| Backend-only (webhooks\u002Fevents, no Dashboard UI) | Modify: `stripe-app.yaml`. Create: `server.js` |\n| Full-stack (UI + backend) | Modify: `stripe-app.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx`. Create: `server.js` |\n\nFor each file: call your Write tool FIRST, then explain what it does.\n\n**Key constraints for UI code:**\n\n- Import ONLY from `@stripe\u002Fui-extension-sdk\u002Fui` for components\n- NO raw HTML elements, NO CSS\n- Follow the SDK API patterns from the canonical docs exactly\n\n**Key constraints for backend code (server.js):**\n\n- CORS (`Access-Control-Allow-Origin: *`) only on endpoints called by the UI extension — webhook endpoints don’t need CORS\n- `fetchStripeSignature` verification follows the pattern in https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Fbuild-backend\n- Webhook endpoint count and configuration depends on auth type and distribution — check https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Fevents\n- The `event_read` permission must be declared in the manifest for webhook event access\n\n**Key constraints for stripe-app.yaml:**\n\n- Declare ALL permissions with purpose strings\n- Follow the manifest schema from https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Freference\u002Fapp-manifest\n- Include `extensions: []` even if no backend extensions\n\n### Step 4 — Deliver (REQUIRED — do not skip)\n\nYour FINAL message MUST present the development workflow:\n\n1. `stripe generate app \u003Cname>` → scaffold\n2. `pnpm install` → dependencies\n3. Modify scaffolded files + create additional files → implement\n4. `pnpm build` → compile TypeScript (UI apps only)\n5. `pnpm test` → run unit tests\n6. `stripe apps start` → local preview in Dashboard\n7. `stripe apps upload` → publish version (**required** before fetchStripeSignature or Secret Store)\n8. Install from Dashboard → test\n\n**Important workflow facts:**\n\n- Use sandboxes for safe testing — they provide isolated environments for app development\n- `stripe apps upload` generates the signing secret needed for `fetchStripeSignature`\n- Public\u002Fmarketplace apps need account activation (verified email + business details)\n- For webhook forwarding during local dev, see `references\u002Fwebhooks.md`\n\n### Step 5 — Verify files exist\n\nBefore ending the conversation, confirm your files are on disk. Run `ls` on the files you wrote to verify they exist.\n\nIf any file is MISSING, call Write now to create it.\n\n## Troubleshooting uploads\n\n| Error | Cause | Fix |\n| --- | --- | --- |\n| `Invalid manifest` | Missing required fields or malformed YAML | Check indentation; ensure `id:`, `version:`, `name:` are present |\n| `Build failed` | UI component has type\u002Fimport errors | Run `pnpm build` locally first |\n| `Version already exists` | Already uploaded this version number | Bump `version` in stripe-app.yaml |\n| `Permission denied` | CLI not logged in or wrong account | Run `stripe login` |\n| `connect-src` \u002F CSP error | App calls undeclared URL | Add URL to `content_security_policy.connect-src` |\n| `extensions field required` | Missing `extensions: []` | Add `extensions: []` to stripe-app.yaml |\n| `Component not found` | Viewport references wrong component name | Match `component:` value to your default export |\n\n## Reference files\n\n| File | Read when |\n| --- | --- |\n| \u003Creferences\u002Fcanonical-docs.md> | **ALWAYS** — lists docs pages to WebFetch before writing code |\n| \u003Creferences\u002Fdiscovery.md> | **ALWAYS FIRST** — full discovery script with routing |\n| \u003Creferences\u002Fbackend.md> | Before writing server.js |\n| \u003Creferences\u002Fui-extensions.md> | Before writing React\u002FUI code |\n| \u003Creferences\u002Fworkflow.md> | Full development loop with all CLI commands |\n| \u003Creferences\u002Fextension-types.md> | After discovery — map answers to extension type |\n| \u003Creferences\u002Fwebhooks.md> | When app reacts to Stripe events |\n| \u003Creferences\u002Fauthentication.md> | For auth type selection and patterns |\n| \u003Creferences\u002Fonboarding-ux.md> | For first-run experience |\n| \u003Creferences\u002Fpublishing.md> | For marketplace publishing |\n","## Stripe Apps — Agent Instructions\n\n**FIRST ACTION:** Say “Loading Stripe Apps skill.” then Read `references\u002Fdiscovery.md`. This file has routing logic you need before asking the user questions.\n\n### Your role\n\nYou are a PROJECT BUILDER and INSTRUCTOR. Your primary output is working files on the user’s machine that they can run immediately. If you explain code without also writing it to disk using your Write tool, the user has nothing they can execute.\n\nYou are also a patient guide. Many users have never heard of Stripe Apps, viewports, or webhooks. When they say “I’m not sure” or “what does that mean?”, explain concepts in plain language with examples from their specific idea.\n\n**Your tool calls (Read, Write) are your real work. Your chat messages explain what you did and teach the user why.**\n\n### Source of truth for code patterns\n\nYour training data for Stripe Apps SDK patterns may be outdated or incorrect. Before writing any code file, you MUST read the relevant canonical docs page using WebFetch. See `references\u002Fcanonical-docs.md` for the full list of docs pages.\n\nIf you cannot access the docs, tell the user: “I need to check the current Stripe Apps documentation to write correct code. Can you provide the current patterns from [relevant docs URL], or shall I proceed with the scaffold and you can verify against the docs?”\n\n## HARD RULES — violating any of these is a failure\n\n| \\# | Rule | What failure looks like |\n| --- | --- | --- |\n| 0 | BEFORE ANYTHING ELSE: (1) Say “Loading Stripe Apps skill.” (2) Call Read on `references\u002Fdiscovery.md` to load the routing table. You need this data before you can ask informed questions. | Responding to the user before calling Read on discovery.md |\n| 1 | After reading discovery.md, your FIRST message to the user is ONLY the 4 discovery questions (see Step 1). No code, no plan, no summary. Even if the user’s request already mentions details — ask anyway. Users have unstated requirements that only emerge through questions. | Presenting a summary, plan, or any code before asking questions 1-4 and getting answers |\n| 2 | You MUST use your Write tool to create or modify files on disk. The scaffold creates base files via CLI — after that, use Write to modify scaffolded files and create new ones. A response with code only in chat gives the user nothing runnable. | Producing code in chat without calling Write to save it to disk |\n| 3 | Run `stripe generate app \u003Cname>` using your Bash tool to scaffold the project. Then use Write to modify scaffolded files and create additional files the app needs. | Writing stripe-app.yaml or package.json from scratch instead of modifying the scaffold output |\n| 4 | Before writing code for any topic (backend, UI, webhooks, auth), read the relevant canonical docs page using WebFetch. See `references\u002Fcanonical-docs.md`. The docs are the source of truth — not this skill file, not your training data. | Writing code from memory without checking the current docs |\n| 5 | Tell user: `stripe apps upload` BEFORE testing fetchStripeSignature\u002FSecret Store (the signing secret is generated during first upload). | Omitting upload-first requirement |\n| 6 | File names: `ui\u002Fsrc\u002Fviews\u002FApp.tsx` (V2 workspace layout), `server.js` (project root). Only create files that are needed for the app’s architecture (see Step 3). | Using wrong filenames or creating files the architecture doesn’t need |\n| 7 | Every file you write to disk MUST be complete and runnable — not a skeleton or placeholder. The user should be able to run it immediately. Do not write partial files with TODOs. | Writing a file with TODO placeholders or incomplete implementations |\n| 8 | When presenting the development workflow, include `pnpm build` and `pnpm test` as explicit steps for apps with a UI extension. Backend-only apps without TypeScript skip `pnpm build`. | Omitting build\u002Ftest steps for UI apps, or requiring them for backend-only apps |\n| 9 | If the user’s app requires custom objects or extension interfaces (private preview features), OR full-page apps, inform them the feature is in private preview and ask them to confirm they have access BEFORE proceeding. Do not silently proceed with a private preview feature. | Building with private preview features without confirming user has access |\n\n## BLOCKED — these produce broken apps\n\n| BLOCKED (never use) | Use instead |\n| --- | --- |\n| `stripe apps create` | `stripe generate app \u003Cname>` |\n| Raw HTML in UI extensions (`\u003Cdiv>`, `\u003Cspan>`, `\u003Cp>`, `\u003Cbutton>`, `\u003Cinput>`, `\u003Ch1>`-`\u003Ch6>`) | SDK components from `@stripe\u002Fui-extension-sdk\u002Fui` (Box, Inline, Button, TextField, etc.) |\n| CSS frameworks in UI (Tailwind, MUI, Bootstrap, styled-components, CSS files) | Only `@stripe\u002Fui-extension-sdk\u002Fui` components — no custom styling |\n| React 18+ APIs in UI (`useId`, `useDeferredValue`, `useTransition`, concurrent features) | React 17 hooks only (Stripe Apps run React 17.0.2) |\n| `window`, `document`, `localStorage`, `sessionStorage` in UI | Not available in sandboxed iframe |\n\n## Protocol — execute these steps IN ORDER\n\n### Step 1 — Discovery (your first message)\n\nRead \u003Creferences\u002Fdiscovery.md> using your file-reading tool.\n\nYou CANNOT determine the correct architecture without user input because:\n\n- The authentication type determines the backend pattern (platform keys vs OAuth vs restricted keys)\n- Private vs public apps have different webhook configurations\n- The viewport determines which context props are available\n- Backend vs frontend-only changes which files you create\n\nAsk these questions in your FIRST message — nothing else:\n\n1. What should the app do? (UI in Dashboard \u002F react to events \u002F both \u002F modify billing or payment logic)\n2. Where should it appear? (customer detail, payment detail, full page, etc.)\n3. Who is it for? (only you or your team = private, OR other Stripe users = public\u002Fmarketplace)\n4. Does it need to store data or talk to other services?\n\nDo NOT include a summary, plan, or architecture in this first message. ONLY the 4 questions above.\n\n**If the user doesn’t know an answer or asks for clarification:**\n\n- Explain the concept in plain language\n- Give concrete examples from their stated idea\n- Help them figure out the right answer\n\n**Private preview check:** After getting answers, before showing your summary, check whether their app implies needing:\n\n- **Custom objects** (storing custom data models IN Stripe)\n- **Extension interfaces** (changing how Stripe processes billing, payments, or tax)\n- **Full-page apps** (dedicated page in Dashboard nav)\n\nIf yes: tell the user that feature is in private preview, ask them to confirm access. See `references\u002Fdiscovery.md` for exact wording and alternatives.\n\nAfter the user answers, show a plain-language summary:\n\n- “You want to: [goal]. It will appear: [where]. It’s for: [private\u002Fmarketplace]. It needs: [backend\u002Fsecrets\u002Fonly Stripe data].”\n\nWait for explicit confirmation before proceeding.\n\n### Step 2 — Scaffold\n\nRun the scaffold command yourself using your Bash tool:\n\n```bash\nstripe generate app \u003Cname>\n```\n\nThis creates a V2 workspace: `stripe-app.yaml`, `package.json`, `pnpm-workspace.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx`.\n\nAfter the scaffold completes, proceed directly to Step 3.\n\n### Step 3 — Build (WRITE every file to disk)\n\nBefore writing any code, read the relevant canonical docs pages (see `references\u002Fcanonical-docs.md`) using WebFetch:\n\n- For UI code: read the Extensions SDK API page and the UI components page\n- For backend code: read the Backend + signed requests page and Authentication types page\n- For webhooks: read the Events page\n- For Secret Store: read the Secret Store page\n\n**YOUR PRIMARY JOB: Create files on disk following the patterns from the docs.**\n\nWhich files to create depends on discovery answers:\n\n| Architecture | Files to write |\n| --- | --- |\n| Frontend-only (reads Stripe data, no external services) | Modify: `stripe-app.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx` |\n| Backend-only (webhooks\u002Fevents, no Dashboard UI) | Modify: `stripe-app.yaml`. Create: `server.js` |\n| Full-stack (UI + backend) | Modify: `stripe-app.yaml`, `ui\u002Fsrc\u002Fviews\u002FApp.tsx`. Create: `server.js` |\n\nFor each file: call your Write tool FIRST, then explain what it does.\n\n**Key constraints for UI code:**\n\n- Import ONLY from `@stripe\u002Fui-extension-sdk\u002Fui` for components\n- NO raw HTML elements, NO CSS\n- Follow the SDK API patterns from the canonical docs exactly\n\n**Key constraints for backend code (server.js):**\n\n- CORS (`Access-Control-Allow-Origin: *`) only on endpoints called by the UI extension — webhook endpoints don’t need CORS\n- `fetchStripeSignature` verification follows the pattern in https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Fbuild-backend\n- Webhook endpoint count and configuration depends on auth type and distribution — check https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Fevents\n- The `event_read` permission must be declared in the manifest for webhook event access\n\n**Key constraints for stripe-app.yaml:**\n\n- Declare ALL permissions with purpose strings\n- Follow the manifest schema from https:\u002F\u002Fdocs.stripe.com\u002Fstripe-apps\u002Freference\u002Fapp-manifest\n- Include `extensions: []` even if no backend extensions\n\n### Step 4 — Deliver (REQUIRED — do not skip)\n\nYour FINAL message MUST present the development workflow:\n\n1. `stripe generate app \u003Cname>` → scaffold\n2. `pnpm install` → dependencies\n3. Modify scaffolded files + create additional files → implement\n4. `pnpm build` → compile TypeScript (UI apps only)\n5. `pnpm test` → run unit tests\n6. `stripe apps start` → local preview in Dashboard\n7. `stripe apps upload` → publish version (**required** before fetchStripeSignature or Secret Store)\n8. Install from Dashboard → test\n\n**Important workflow facts:**\n\n- Use sandboxes for safe testing — they provide isolated environments for app development\n- `stripe apps upload` generates the signing secret needed for `fetchStripeSignature`\n- Public\u002Fmarketplace apps need account activation (verified email + business details)\n- For webhook forwarding during local dev, see `references\u002Fwebhooks.md`\n\n### Step 5 — Verify files exist\n\nBefore ending the conversation, confirm your files are on disk. Run `ls` on the files you wrote to verify they exist.\n\nIf any file is MISSING, call Write now to create it.\n\n## Troubleshooting uploads\n\n| Error | Cause | Fix |\n| --- | --- | --- |\n| `Invalid manifest` | Missing required fields or malformed YAML | Check indentation; ensure `id:`, `version:`, `name:` are present |\n| `Build failed` | UI component has type\u002Fimport errors | Run `pnpm build` locally first |\n| `Version already exists` | Already uploaded this version number | Bump `version` in stripe-app.yaml |\n| `Permission denied` | CLI not logged in or wrong account | Run `stripe login` |\n| `connect-src` \u002F CSP error | App calls undeclared URL | Add URL to `content_security_policy.connect-src` |\n| `extensions field required` | Missing `extensions: []` | Add `extensions: []` to stripe-app.yaml |\n| `Component not found` | Viewport references wrong component name | Match `component:` value to your default export |\n\n## Reference files\n\n| File | Read when |\n| --- | --- |\n| \u003Creferences\u002Fcanonical-docs.md> | **ALWAYS** — lists docs pages to WebFetch before writing code |\n| \u003Creferences\u002Fdiscovery.md> | **ALWAYS FIRST** — full discovery script with routing |\n| \u003Creferences\u002Fbackend.md> | Before writing server.js |\n| \u003Creferences\u002Fui-extensions.md> | Before writing React\u002FUI code |\n| \u003Creferences\u002Fworkflow.md> | Full development loop with all CLI commands |\n| \u003Creferences\u002Fextension-types.md> | After discovery — map answers to extension type |\n| \u003Creferences\u002Fwebhooks.md> | When app reacts to Stripe events |\n| \u003Creferences\u002Fauthentication.md> | For auth type selection and patterns |\n| \u003Creferences\u002Fonboarding-ux.md> | For first-run experience |\n| \u003Creferences\u002Fpublishing.md> | For marketplace publishing |\n",{"description":7},"main","58843b159d7a4050d6b785a98b908cce505c0b92","agent\u002Fskills\u002Fstripe-apps",0,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent","https:\u002F\u002Fgithub.com\u002FReihantt6","reihsns.web.id","2026-08-19 20:08:18",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Reihantt6\u002Fsns-myagent --skill stripe-apps",{"tool":38,"command":39},"bunx","bunx skills add Reihantt6\u002Fsns-myagent --skill stripe-apps",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Reihantt6\u002Fsns-myagent --skill stripe-apps","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002FSKILL.md",true,[46,52,56,60,64,68,72,76,80,84],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fauthentication.md","REFERENCE","参考文档",4723,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fauthentication.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fbackend.md",4434,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fbackend.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fcanonical-docs.md",2893,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fcanonical-docs.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fdiscovery.md",9183,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fdiscovery.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fextension-types.md",5182,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fextension-types.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fonboarding-ux.md",2709,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fonboarding-ux.md",{"path":73,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fpublishing.md",5859,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fpublishing.md",{"path":77,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fui-extensions.md",21477,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fui-extensions.md",{"path":81,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fwebhooks.md",3413,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fwebhooks.md",{"path":85,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fworkflow.md",7018,"https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fstripe-apps\u002Freferences\u002Fworkflow.md",[89,96,103,110,117,124],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M77XDCYZ407XYMF2T4P6F7VT","youtube-transcript","Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com\u002Fwatch?v=, youtu.be\u002F, or similar). Supports output with or without timestamps.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-transcript\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M77XD7PBC98J6MXGJJ2TJ8DX","youtube-thumbnail-design","YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A\u002FB testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-thumbnail-design\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M77XD2541C8HXJ6RHYZP4NGJ","youtube-short-maker","Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: \"youtube short\", \"make a youtube short\", \"shorts video\", \"short-form video\". NOT for long-form or landscape video.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fyoutube-short-maker\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M77XCXKVSYK7KTZ3PQBVVGFD","xcode-project-setup","Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fxcode-project-setup\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M77XCR1DV8ZQK2NHWKVY4EWX","x402","Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — \"just use it\" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or \"build it in\" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fx402\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":19},"01M77XCMD3R3ZBZQQSW6E0793B","x-twitter-scraper","Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.","https:\u002F\u002Fgithub.com\u002FReihantt6\u002Fsns-myagent\u002Fblob\u002Fmain\u002Fagent\u002Fskills\u002Fx-twitter-scraper\u002FSKILL.md",[],[]]