[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77PJRZSDHQWKWS1P2T3WTFF":3,"skill-same:01M77PJRZSDHQWKWS1P2T3WTFF":56},{"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":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M77PJRZSDHQWKWS1P2T3WTFF","adapty-flow-automation",null,"Automate Adapty Flows (v4 Beta) and paywall\u002Fplacement config that the official CLI and public API can't reach - flow authoring, publishing, flow-type placements - by driving Adapty's internal dashboard \"portal\" API with a headless-capable bearer token. Use when the user wants to script Adapty flow create\u002Fedit\u002Fpublish, wire flow placements, treat a flow as versioned code, verify a flow actually went live, or asks why an Adapty v4 flow renders the native fallback instead of the remote flow.","Necmttn\u002Fskills","Necmttn","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5212808?v=4","01M77PDTX0P2888A46VQ6DREZG","Neco","01M77PDTXNATPR101437VV6H7Y",0,"MIT","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fadapty-flow-automation\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: adapty-flow-automation\ndescription: Automate Adapty Flows (v4 Beta) and paywall\u002Fplacement config that the official CLI and public API can't reach - flow authoring, publishing, flow-type placements - by driving Adapty's internal dashboard \"portal\" API with a headless-capable bearer token. Use when the user wants to script Adapty flow create\u002Fedit\u002Fpublish, wire flow placements, treat a flow as versioned code, verify a flow actually went live, or asks why an Adapty v4 flow renders the native fallback instead of the remote flow.\n---\n\n# Automating Adapty Flows\n\nAdapty has **three** API surfaces plus one undocumented internal one. Flows (v4 Beta) live only in the internal one. Pick the surface by task; don't reach for the browser when a real API covers it.\n\n| Surface | Base \u002F Auth | Covers | Spec |\n|---|---|---|---|\n| **Server-side v2** | `api.adapty.io` \u002F `Api-Key \u003Csecret>` | profiles, **grant access level** (Rescue-Pass leaf), transactions, analytics export | [Postman collection](https:\u002F\u002Fadapty.io\u002Fdocs\u002Fserver-side-api-specs) |\n| **Developer (CLI)** | `api-admin.adapty.io\u002Fapi\u002Fv1\u002Fdeveloper` \u002F oauth bearer | apps, products, paywalls, **paywall-type** placements, access-levels, segments (read-only) | none published; zod schemas in `adapty` npm pkg `dist\u002Flib\u002Fapi-schemas.js` |\n| **SDK read** | `api.adapty.io\u002Fapi\u002Fv1\u002Fsdk\u002F...` \u002F `Api-Key \u003Cpublic>` | placement variation fetch - **publish verification** | undocumented, stable |\n| **Portal (internal)** | `api-admin.adapty.io\u002Fapi\u002Fv1\u002Fportal\u002F{app_id}\u002F` \u002F dashboard bearer | **flows author + publish**, flow-type placements, everything the builder does | none - sniffed, fragile |\n\nFull portal endpoint map + request shapes: [portal-api.md](portal-api.md).\nThe four gotchas that make a v4 flow silently fall back to native: [flow-gotchas.md](flow-gotchas.md).\n\n## Decision: which surface\n\n- Grant\u002Frevoke entitlement, profile ops → **server-side v2** (secret key). Documented, stable, safe for backend.\n- Products, paywalls, **paywall-type** placements CRUD → **developer API** via `bunx adapty` CLI (`adapty auth login` once). No flows here.\n- Flow create\u002Fedit\u002F**publish**, **flow-type** placements → **portal API** (this skill's core). Nothing official reaches these.\n- \"Did my flow actually go live?\" → **SDK read endpoint**, always. See Verify below.\n\n## Portal auth (the unlock)\n\nThe dashboard authenticates portal calls with a bearer token in **localStorage**, not a cookie - so once extracted it works fully headless (`credentials: 'omit'` returns 200). The CLI's oauth token is a **different realm** and 401s on portal.\n\nExtract once per session, from a logged-in app.adapty.io tab:\n\n```js\nlocalStorage.getItem('adapty\u002Ftoken')   \u002F\u002F 40-char opaque string\n```\n\nThen every portal call:\n\n```\nAuthorization: Bearer \u003Ctoken>\n```\n\nToken is session-scoped (a `fox_auth_timestamp` refresh mechanism exists); expect to re-extract when calls start 401ing.\n\n## Flow-as-code pipeline\n\nThe entire flow - screens, elements, props, product bindings, triggers - is **one JSON document** at `GET\u002FPUT in-apps\u002Fflows\u002F{flow_id}\u002Fconfig\u002F`, guarded by an optimistic-lock field `expected_updated_at`.\n\n1. **Pull** `GET ...\u002Fconfig\u002F` → commit the JSON to the repo. The flow is now a versioned artifact.\n2. **Edit** locally (copy tweaks, product ids, A\u002FB variants), keep `expected_updated_at` from the last GET.\n3. **Push** `PUT ...\u002Fconfig\u002F`.\n4. **Publish** `POST in-apps\u002Fflows\u002F{flow_id}\u002Fpublish\u002F` (empty body). This is the step the builder hides behind a confirmation modal - miss it and the draft never goes live while the UI reads \"Changes saved\".\n5. **Verify** (below). Never trust the publish response alone.\n\n## Verify a flow is live (do this after EVERY mutation)\n\nHit the public SDK read endpoint with the app's **public** key:\n\n```\nGET https:\u002F\u002Fapi.adapty.io\u002Fapi\u002Fv1\u002Fsdk\u002Fin-apps\u002F{public_key}\u002Fflow\u002Fvariations\u002F{placement_id}\u002F{profile_hash}\u002F\nAuthorization: Api-Key {public_key}.{public_secret}\nadapty-sdk-version: 4.0.0\n```\n\n- `flow_version_id` must **change** after a publish.\n- `variations` array must be **non-empty**. Empty ⇒ the SDK maps it to zero `flow.paywalls` ⇒ `getPaywallProducts` throws `noProductIDsFound` ⇒ the app silently renders its native fallback. This is the single most common \"why isn't my flow showing\" cause.\n\nPoll it in a loop after publish; CDN propagation is a few seconds.\n\n## Safety\n\n- Portal API is **unofficial** - Adapty can change request shapes on any dashboard release. Pin exact shapes, re-sniff if calls break (open app.adapty.io, DevTools → Network, filter `api-admin`, or re-run the fetch-hook in [portal-api.md](portal-api.md)).\n- Always run the SDK-endpoint verify after a portal mutation. Treat a green publish response as unproven until `variations` is non-empty.\n- Flow placements on a **live** SDK key affect real users the moment they publish. On an unreleased app that's harmless; before launch, repoint\u002Fdelete test placements.\n","# Automating Adapty Flows\n\nAdapty has **three** API surfaces plus one undocumented internal one. Flows (v4 Beta) live only in the internal one. Pick the surface by task; don't reach for the browser when a real API covers it.\n\n| Surface | Base \u002F Auth | Covers | Spec |\n|---|---|---|---|\n| **Server-side v2** | `api.adapty.io` \u002F `Api-Key \u003Csecret>` | profiles, **grant access level** (Rescue-Pass leaf), transactions, analytics export | [Postman collection](https:\u002F\u002Fadapty.io\u002Fdocs\u002Fserver-side-api-specs) |\n| **Developer (CLI)** | `api-admin.adapty.io\u002Fapi\u002Fv1\u002Fdeveloper` \u002F oauth bearer | apps, products, paywalls, **paywall-type** placements, access-levels, segments (read-only) | none published; zod schemas in `adapty` npm pkg `dist\u002Flib\u002Fapi-schemas.js` |\n| **SDK read** | `api.adapty.io\u002Fapi\u002Fv1\u002Fsdk\u002F...` \u002F `Api-Key \u003Cpublic>` | placement variation fetch - **publish verification** | undocumented, stable |\n| **Portal (internal)** | `api-admin.adapty.io\u002Fapi\u002Fv1\u002Fportal\u002F{app_id}\u002F` \u002F dashboard bearer | **flows author + publish**, flow-type placements, everything the builder does | none - sniffed, fragile |\n\nFull portal endpoint map + request shapes: [portal-api.md](portal-api.md).\nThe four gotchas that make a v4 flow silently fall back to native: [flow-gotchas.md](flow-gotchas.md).\n\n## Decision: which surface\n\n- Grant\u002Frevoke entitlement, profile ops → **server-side v2** (secret key). Documented, stable, safe for backend.\n- Products, paywalls, **paywall-type** placements CRUD → **developer API** via `bunx adapty` CLI (`adapty auth login` once). No flows here.\n- Flow create\u002Fedit\u002F**publish**, **flow-type** placements → **portal API** (this skill's core). Nothing official reaches these.\n- \"Did my flow actually go live?\" → **SDK read endpoint**, always. See Verify below.\n\n## Portal auth (the unlock)\n\nThe dashboard authenticates portal calls with a bearer token in **localStorage**, not a cookie - so once extracted it works fully headless (`credentials: 'omit'` returns 200). The CLI's oauth token is a **different realm** and 401s on portal.\n\nExtract once per session, from a logged-in app.adapty.io tab:\n\n```js\nlocalStorage.getItem('adapty\u002Ftoken')   \u002F\u002F 40-char opaque string\n```\n\nThen every portal call:\n\n```\nAuthorization: Bearer \u003Ctoken>\n```\n\nToken is session-scoped (a `fox_auth_timestamp` refresh mechanism exists); expect to re-extract when calls start 401ing.\n\n## Flow-as-code pipeline\n\nThe entire flow - screens, elements, props, product bindings, triggers - is **one JSON document** at `GET\u002FPUT in-apps\u002Fflows\u002F{flow_id}\u002Fconfig\u002F`, guarded by an optimistic-lock field `expected_updated_at`.\n\n1. **Pull** `GET ...\u002Fconfig\u002F` → commit the JSON to the repo. The flow is now a versioned artifact.\n2. **Edit** locally (copy tweaks, product ids, A\u002FB variants), keep `expected_updated_at` from the last GET.\n3. **Push** `PUT ...\u002Fconfig\u002F`.\n4. **Publish** `POST in-apps\u002Fflows\u002F{flow_id}\u002Fpublish\u002F` (empty body). This is the step the builder hides behind a confirmation modal - miss it and the draft never goes live while the UI reads \"Changes saved\".\n5. **Verify** (below). Never trust the publish response alone.\n\n## Verify a flow is live (do this after EVERY mutation)\n\nHit the public SDK read endpoint with the app's **public** key:\n\n```\nGET https:\u002F\u002Fapi.adapty.io\u002Fapi\u002Fv1\u002Fsdk\u002Fin-apps\u002F{public_key}\u002Fflow\u002Fvariations\u002F{placement_id}\u002F{profile_hash}\u002F\nAuthorization: Api-Key {public_key}.{public_secret}\nadapty-sdk-version: 4.0.0\n```\n\n- `flow_version_id` must **change** after a publish.\n- `variations` array must be **non-empty**. Empty ⇒ the SDK maps it to zero `flow.paywalls` ⇒ `getPaywallProducts` throws `noProductIDsFound` ⇒ the app silently renders its native fallback. This is the single most common \"why isn't my flow showing\" cause.\n\nPoll it in a loop after publish; CDN propagation is a few seconds.\n\n## Safety\n\n- Portal API is **unofficial** - Adapty can change request shapes on any dashboard release. Pin exact shapes, re-sniff if calls break (open app.adapty.io, DevTools → Network, filter `api-admin`, or re-run the fetch-hook in [portal-api.md](portal-api.md)).\n- Always run the SDK-endpoint verify after a portal mutation. Treat a green publish response as unproven until `variations` is non-empty.\n- Flow placements on a **live** SDK key affect real users the moment they publish. On an unreleased app that's harmless; before launch, repoint\u002Fdelete test placements.\n",{"name":5,"description":7},"main","b321807e50f72ccb0df5da9aaeba42088271907e","skills\u002Fengineering\u002Fadapty-flow-automation","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills","https:\u002F\u002Fgithub.com\u002FNecmttn","https:\u002F\u002Fnecmttn.com","Fractional CTO - \r\nAI Solution Architect","2026-11-07 08:05:35",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Necmttn\u002Fskills --skill adapty-flow-automation",{"tool":38,"command":39},"bunx","bunx skills add Necmttn\u002Fskills --skill adapty-flow-automation",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Necmttn\u002Fskills --skill adapty-flow-automation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fadapty-flow-automation\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"flow-gotchas.md","REFERENCE","参考文档",3339,"https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fadapty-flow-automation\u002Fflow-gotchas.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"portal-api.md",5926,"https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fadapty-flow-automation\u002Fportal-api.md",[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M77PNJ1JCKWHR2XJDBX8Q85P","wiki","Recall from the personal LLM wiki at ~\u002Fwiki. Use when the user asks what the wiki says, wants prior thinking\u002Fintuition on a concept, or when grounding a design or decision in previously synthesized knowledge. Read-only - never writes to the wiki.","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fwiki\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M77PNERKEH3ZN11HMC6YEH9G","wiki-ingest","Curate a source into the personal LLM wiki at ~\u002Fwiki following its SCHEMA.md - a file, URL, research output, ax session, or a pending ~\u002Fwiki\u002Finbox\u002F brief. Use when the user says \"add this to the wiki\", \"ingest this\", \"promote the inbox\", or after research worth keeping long-term.","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fwiki-ingest\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M77PNB9SMTTG3D80BXGCY16B","wiki-harvest","Propose-only sweep of recent coding sessions (via the ax CLI) for recurring concepts that are missing from, or should update, the personal LLM wiki at ~\u002Fwiki. Writes candidate briefs to ~\u002Fwiki\u002Finbox\u002F only - never wiki pages. Use on schedule or when the user asks \"harvest the wiki\" or \"what concepts am I repeating\".","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fwiki-harvest\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M77PN73WAF08PCWBYXST9BW6","no-ai-slop","Strip AI-slop patterns from a draft while preserving the writer's voice, or detect slop without rewriting. Use as the mandatory final pass on any copy before shipping, when the user wants a draft clearer\u002Fless AI-sounding, or when asked \"is this AI slop?\", \"audit this writing\", \"does this read as AI\".","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fno-ai-slop\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M77PN2H1QTPD9GD6VBJ3YBPN","aso-appstore-screenshots","Generate high-converting App Store screenshots by analyzing your app's codebase, discovering core benefits, and creating ASO-optimized screenshot images using Nano Banana Pro.","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Faso-appstore-screenshots\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Faso-appstore-screenshots\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M77PMVGA58GA46JCFJW2JH5X","app-idea","Run a new or existing consumer\u002FAI app idea through the golden-track playbook (~\u002Fwiki\u002Fplaybook\u002Fapps.md) from intake to verdict, write a verdict card, stop for the owner, and ratchet owner overrides back into the doctrine. Use when the user shares an app idea, asks \"should I build X\", \"audit \u003Capp>\", \"re-score \u003Capp>\", or pastes an idea in a product context. Never builds; never promotes a rule on its own.","https:\u002F\u002Fgithub.com\u002FNecmttn\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Fapp-idea\u002FSKILL.md",[],[]]