How do I install the Asc Promoted Purchases skill?

Run npx skillmds@latest add tddworks/asc-promoted-purchases in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Asc Promoted Purchases safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Asc Promoted Purchases?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Asc Promoted Purchases free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Asc Promoted Purchases?

tddworks (@tddworks) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Asc Promoted Purchases by tddworks — Agent Skill

Name: Asc Promoted Purchases
Author: tddworks

Asc Promoted Purchases

Manage App Store product page promoted purchase slots using the `asc` CLI tool. Use this skill when: (1) Listing slots: "asc promoted-purchases list --app-id ID" (2) Promoting an IAP or subscription: "asc promoted-purchases create --app-id ID (--iap-id ID | --subscription-id ID)" (3) Updating visibility / enabled state: "asc promoted-purchases update --promoted-id ID --visible|--hidden --enabled|--disabled" (4) Deleting a slot: "asc promoted-purchases delete --promoted-id ID" (5) User says "promoted purchase", "promoted IAP", "feature on App Store", "App Store product page promotion", "promoted slot"

tddworks Updated Sep 17, 2026

File contents

asc Promoted Purchases

Manage App Store product page Promoted In-App Purchases — the featured IAPs / auto-renewable subscriptions surfaced under an app's product page on the App Store. Each slot promotes either an IAP or a subscription (mutually exclusive) and goes through App Review separately from the underlying product.

List

asc promoted-purchases list --app-id <APP_ID> [--limit N] [--pretty]

Create

Exactly one of --iap-id or --subscription-id is required (the command validates and rejects both/neither):

# Promote an in-app purchase
asc promoted-purchases create --app-id <APP_ID> --iap-id <IAP_ID> --visible --enabled

# Promote an auto-renewable subscription
asc promoted-purchases create --app-id <APP_ID> --subscription-id <SUB_ID> --hidden --disabled

--visible / --hidden flip isVisibleForAllUsers. --enabled / --disabled flip isEnabled. Defaults: isVisibleForAllUsers=true, isEnabled left unchanged when both flags omitted.

Update

asc promoted-purchases update --promoted-id <PROMOTED_ID> [--visible | --hidden] [--enabled | --disabled]

Omitting a flag pair leaves that field unchanged.

Delete

asc promoted-purchases delete --promoted-id <PROMOTED_ID>

State semantics

PromotedPurchaseState exposes semantic booleans:

Boolean	True when state is
`isLocked`	`WAITING_FOR_REVIEW`, `IN_REVIEW`
`isApproved`	`APPROVED`

State-aware affordances

JSON responses suppress mutations that ASC would reject as 409 conflicts:

State	`update` link	`delete` link
`approved` / `rejected` / `prepareForSubmission` / `developerActionNeeded`	shown	shown
`waitingForReview` / `inReview` (i.e. `state.isLocked`)	suppressed	suppressed

{
  "affordances": {
    "listSiblings": "asc promoted-purchases list --app-id <APP_ID>",
    "update":       "asc promoted-purchases update --promoted-id <ID>",   // omitted while in review
    "delete":       "asc promoted-purchases delete --promoted-id <ID>"    // omitted while in review
  }
}

Resolve App ID

See project-context.md — check .asc/project.json before asking the user or running asc apps list.

Typical Workflow

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')

# Promote an IAP, visible to all users, slot enabled.
PROMO_ID=$(asc promoted-purchases create --app-id "$APP_ID" \
  --iap-id "iap-1" --visible --enabled \
  | jq -r '.data[0].id')

# Later: hide it temporarily without deleting
asc promoted-purchases update --promoted-id "$PROMO_ID" --hidden

# Or just remove the slot
asc promoted-purchases delete --promoted-id "$PROMO_ID"

Reference

For full domain-model and REST detail see docs/features/promoted-purchases.md.

---name: asc-promoted-purchasesdescription: Manage App Store product page promoted purchase slots using the `asc` CLI tool. Use this skill when: (1) Listing slots: "asc promoted-purchases list --app-id ID" (2) Promoting an IAP or subscription: "asc promoted-purchases create --app-id ID (--iap-id ID | --subscription-id ID)" (3) Updating visibility / enabled state: "asc promoted-purchases update --promoted-id ID --visible|--hidden --enabled|--disabled" (4) Deleting a slot: "asc promoted-purchases delete --promoted-id ID" (5) User says "promoted purchase", "promoted IAP", "feature on App Store", "App Store product page promotion", "promoted slot"---# asc Promoted PurchasesManage App Store product page **Promoted In-App Purchases** — the featured IAPs / auto-renewable subscriptions surfaced under an app's product page on the App Store. Each slot promotes either an IAP or a subscription (mutually exclusive) and goes through App Review separately from the underlying product.## List```bashasc promoted-purchases list --app-id <APP_ID> [--limit N] [--pretty]```## CreateExactly one of `--iap-id` or `--subscription-id` is required (the command validates and rejects both/neither):```bash# Promote an in-app purchaseasc promoted-purchases create --app-id <APP_ID> --iap-id <IAP_ID> --visible --enabled# Promote an auto-renewable subscriptionasc promoted-purchases create --app-id <APP_ID> --subscription-id <SUB_ID> --hidden --disabled````--visible` / `--hidden` flip `isVisibleForAllUsers`. `--enabled` / `--disabled` flip `isEnabled`. Defaults: `isVisibleForAllUsers=true`, `isEnabled` left unchanged when both flags omitted.## Update```bashasc promoted-purchases update --promoted-id <PROMOTED_ID> [--visible | --hidden] [--enabled | --disabled]```Omitting a flag pair leaves that field unchanged.## Delete```bashasc promoted-purchases delete --promoted-id <PROMOTED_ID>```## State semantics`PromotedPurchaseState` exposes semantic booleans:| Boolean | True when state is ||---|---|| `isLocked` | `WAITING_FOR_REVIEW`, `IN_REVIEW` || `isApproved` | `APPROVED` |## State-aware affordancesJSON responses suppress mutations that ASC would reject as 409 conflicts:| State | `update` link | `delete` link ||-------|---------------|---------------|| `approved` / `rejected` / `prepareForSubmission` / `developerActionNeeded` | shown | shown || `waitingForReview` / `inReview` (i.e. `state.isLocked`) | **suppressed** | **suppressed** |```json{ "affordances": { "listSiblings": "asc promoted-purchases list --app-id <APP_ID>", "update": "asc promoted-purchases update --promoted-id <ID>", // omitted while in review "delete": "asc promoted-purchases delete --promoted-id <ID>" // omitted while in review }}```## Resolve App IDSee [project-context.md](../shared/project-context.md) — check `.asc/project.json` before asking the user or running `asc apps list`.## Typical Workflow```bashAPP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')# Promote an IAP, visible to all users, slot enabled.PROMO_ID=$(asc promoted-purchases create --app-id "$APP_ID" \ --iap-id "iap-1" --visible --enabled \ | jq -r '.data[0].id')# Later: hide it temporarily without deletingasc promoted-purchases update --promoted-id "$PROMO_ID" --hidden# Or just remove the slotasc promoted-purchases delete --promoted-id "$PROMO_ID"```## ReferenceFor full domain-model and REST detail see [docs/features/promoted-purchases.md](../../docs/features/promoted-purchases.md).

Frequently asked questions