How do I install the Asc Sales skill?

Run npx skillmds@latest add tomevault-io/asc-sales 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 Sales safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Asc Sales?

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 Sales free to use?

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

Who published Asc Sales?

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

Asc Sales by tomevault-io — Agent Skill

Name: Asc Sales
Author: tomevault-io

File contents

Sales & Analytics

Download sales reports and analytics from App Store Connect.

Arguments: $ARGUMENTS (optional: date in YYYY-MM-DD format)

Prerequisites

Validate setup first:

source .claude/skills/scripts/asc-common.sh
asc_validate || exit 1

Note: Sales reports require a Vendor Number. Find it in App Store Connect under "Payments and Financial Reports".

Daily Sales Summary

# Get yesterday's sales (daily reports have ~1 day delay)
DATE="${1:-$(date -v-1d +%Y-%m-%d)}"
asc analytics sales \
    --vendor "$ASC_VENDOR_NUMBER" \
    --type SALES \
    --subtype SUMMARY \
    --frequency DAILY \
    --date "$DATE" \
    --decompress

Monthly Sales Summary

# Get last month's sales
MONTH=$(date -v-1m +%Y-%m)
asc analytics sales \
    --vendor "$ASC_VENDOR_NUMBER" \
    --type SALES \
    --subtype SUMMARY \
    --frequency MONTHLY \
    --date "$MONTH" \
    --decompress

Subscription Reports

# Detailed subscription report for a month
asc analytics sales \
    --vendor "$ASC_VENDOR_NUMBER" \
    --type SUBSCRIPTION \
    --subtype DETAILED \
    --frequency MONTHLY \
    --date "2025-01" \
    --decompress

Financial Reports

# Download financial report for a region
asc finance reports \
    --vendor "$ASC_VENDOR_NUMBER" \
    --report-type FINANCIAL \
    --region "US" \
    --date "2025-01"

List Available Regions

asc finance regions --output table

App Analytics (Advanced)

For detailed app analytics (downloads, impressions, etc.):

Create Analytics Request

source .claude/skills/scripts/asc-common.sh
asc_load_config

# Request ongoing analytics access
asc analytics request --app "$ASC_APP_ID" --access-type ONGOING

List Analytics Requests

source .claude/skills/scripts/asc-common.sh
asc_load_config

asc analytics requests --app "$ASC_APP_ID" --output table

Download Analytics Data

# Get reports for a request
asc analytics get --request-id "REQUEST_ID"

# Download specific report instance
asc analytics download --request-id "REQUEST_ID" --instance-id "INSTANCE_ID"

Report Types

Type	Description
`SALES`	App sales and downloads
`PRE_ORDER`	Pre-order metrics
`NEWSSTAND`	Newsstand subscriptions
`SUBSCRIPTION`	In-app subscriptions
`SUBSCRIPTION_EVENT`	Subscription events (cancellations, etc.)

Subtypes

Subtype	Description
`SUMMARY`	Aggregated summary data
`DETAILED`	Line-by-line transaction data

Configuration

Add vendor number to .asc/config.json:

{
  "app_id": "YOUR_APP_ID",
  "profile": "IngrediCheck",
  "vendor_number": "YOUR_VENDOR_NUMBER"
}

Or set environment variable:

export ASC_VENDOR_NUMBER="YOUR_VENDOR_NUMBER"

Notes

Daily reports have ~1 day delay
Monthly reports available after month ends
Financial reports require Account Holder, Admin, or Finance role
Large reports are gzip compressed (use --decompress to extract)

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: asc-salesdescription: Download sales reports and analytics from App Store Connect. Use when this capability is needed.---# Sales & AnalyticsDownload sales reports and analytics from App Store Connect.Arguments: $ARGUMENTS (optional: date in YYYY-MM-DD format)## PrerequisitesValidate setup first:```bashsource .claude/skills/scripts/asc-common.shasc_validate || exit 1```**Note**: Sales reports require a Vendor Number. Find it in App Store Connect under "Payments and Financial Reports".## Daily Sales Summary```bash# Get yesterday's sales (daily reports have ~1 day delay)DATE="${1:-$(date -v-1d +%Y-%m-%d)}"asc analytics sales \ --vendor "$ASC_VENDOR_NUMBER" \ --type SALES \ --subtype SUMMARY \ --frequency DAILY \ --date "$DATE" \ --decompress```## Monthly Sales Summary```bash# Get last month's salesMONTH=$(date -v-1m +%Y-%m)asc analytics sales \ --vendor "$ASC_VENDOR_NUMBER" \ --type SALES \ --subtype SUMMARY \ --frequency MONTHLY \ --date "$MONTH" \ --decompress```## Subscription Reports```bash# Detailed subscription report for a monthasc analytics sales \ --vendor "$ASC_VENDOR_NUMBER" \ --type SUBSCRIPTION \ --subtype DETAILED \ --frequency MONTHLY \ --date "2025-01" \ --decompress```## Financial Reports```bash# Download financial report for a regionasc finance reports \ --vendor "$ASC_VENDOR_NUMBER" \ --report-type FINANCIAL \ --region "US" \ --date "2025-01"```### List Available Regions```bashasc finance regions --output table```## App Analytics (Advanced)For detailed app analytics (downloads, impressions, etc.):### Create Analytics Request```bashsource .claude/skills/scripts/asc-common.shasc_load_config# Request ongoing analytics accessasc analytics request --app "$ASC_APP_ID" --access-type ONGOING```### List Analytics Requests```bashsource .claude/skills/scripts/asc-common.shasc_load_configasc analytics requests --app "$ASC_APP_ID" --output table```### Download Analytics Data```bash# Get reports for a requestasc analytics get --request-id "REQUEST_ID"# Download specific report instanceasc analytics download --request-id "REQUEST_ID" --instance-id "INSTANCE_ID"```## Report Types| Type | Description ||------|-------------|| `SALES` | App sales and downloads || `PRE_ORDER` | Pre-order metrics || `NEWSSTAND` | Newsstand subscriptions || `SUBSCRIPTION` | In-app subscriptions || `SUBSCRIPTION_EVENT` | Subscription events (cancellations, etc.) |## Subtypes| Subtype | Description ||---------|-------------|| `SUMMARY` | Aggregated summary data || `DETAILED` | Line-by-line transaction data |## ConfigurationAdd vendor number to `.asc/config.json`:```json{ "app_id": "YOUR_APP_ID", "profile": "IngrediCheck", "vendor_number": "YOUR_VENDOR_NUMBER"}```Or set environment variable:```bashexport ASC_VENDOR_NUMBER="YOUR_VENDOR_NUMBER"```## Notes- Daily reports have ~1 day delay- Monthly reports available after month ends- Financial reports require Account Holder, Admin, or Finance role- Large reports are gzip compressed (use `--decompress` to extract)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/ingredicheck) — claim your Tome and manage your conversions.

Frequently asked questions

Asc Sales