Agent skill

Dx App Analytics Query

ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings.

Apache-2.0Auto-check passedSales & Support

Install Dx App Analytics Query

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dx-app-analytics-query .claude/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .claude/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/dx-app-analytics-query .agents/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .agents/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/dx-app-analytics-query .cursor/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .cursor/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/forcedotcom/sf-skills.git --path skills/dx-app-analytics-query

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/dx-app-analytics-query .gemini/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .gemini/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/dx-app-analytics-query .github/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .github/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install forcedotcom/sf-skills dx-app-analytics-query --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/forcedotcom/sf-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/dx-app-analytics-query .opencode/skills/dx-app-analytics-query && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "dx-app-analytics-query" agent skill from https://github.com/forcedotcom/sf-skills/tree/main/skills/dx-app-analytics-query into .opencode/skills/dx-app-analytics-query/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dx-app-analytics-query", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: dx-app-analytics-query
GitHub stars: 1.1k
Token cost: ~1.7k tokens
SKILL.md length: 551 words
Files: 1
Skills in repo: 248
Repo updated: Oct 3, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings.

The user asks about retrieving managed package usage data
SKILL.md covers When This Skill Owns the Task, Available Types, Request Lifecycle and Common Patterns, plus 2 more sections
Calls sf
Configuring App Analytics simulation mode

What it does

Dx App Analytics Query is an agent skill from forcedotcom/sf-skills. ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings. Use this skill when the user asks about retrieving managed package usage data, configuring App Analytics simulation mode, querying subscriber snapshots, or understanding the AppAnalyticsQueryRequest lifecycle (New → Pending → Complete → Expired). TRIGGER when: user mentions App Analytics, AppAnalyticsQueryRequest, AppAnalyticsSettings, package usage data, subscriber analytics, ISV analytics, or simulation mode for app analytics…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering CRM management. It works with Salesforce. The repository describes itself as: Salesforce's curated collection of agent skills for building applications. Optimized for Agentforce Vibes, compatible with all AI tools. The licence is Apache-2.0.

When your agent uses it

The user asks about retrieving managed package usage data
Configuring App Analytics simulation mode
Querying subscriber snapshots
Understanding the AppAnalyticsQueryRequest lifecycle (New → Pending → Complete → Expired)

Example prompts

“/dx-app-analytics-query”

What it can do on your machine

Read from SKILL.md and the folder at commit 3c15867. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- sf
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dx App Analytics Query loads about 1.7k tokens when it runs. Until then it costs about 188 tokens; SKILL.md has 551 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~188
When it runs · the whole SKILL.md, loaded when a task matches: ~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from forcedotcom/sf-skills at commit 3c15867, republished under its Apache-2.0 licence (© forcedotcom). 551 words, ~1,682 tokens.

Download SKILL.mdSave it as .claude/skills/dx-app-analytics-query/SKILL.md (or your agent's skills folder).

name: dx-app-analytics-query
description: ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings. Use this skill when the user asks about retrieving managed package usage data, configuring App Analytics simulation mode, querying subscriber snapshots, or understanding the AppAnalyticsQueryRequest lifecycle (New → Pending → Complete → Expired). TRIGGER when: user mentions App Analytics, AppAnalyticsQueryRequest, AppAnalyticsSettings, package usage data, subscriber analytics, ISV analytics, or simulation mode for app analytics. DO NOT TRIGGER when: the task is about standard Salesforce reports/dashboards (use reporting skills), custom SOQL on Account/Contact (use querying-soql), or Data Cloud query/search (use retrieving-datacloud).
metadata.version: 1.0
metadata.domains: Developer Experience
metadata.minApiVersion: 56.0
metadata.relatedSkills: platform-soql-query

App Analytics

When This Skill Owns the Task

Use dx-app-analytics-query when the work involves:

Creating AppAnalyticsQueryRequest records via the REST/sObject API
Configuring AppAnalyticsSettings via the Metadata API (simulation mode, opt-out)
Understanding the query lifecycle: New → Pending → Complete → Expired → Failed
Choosing between dataType values: PackageUsageSummary, PackageUsageLog, SubscriberSnapshot
File format and compression options for analytics downloads
Time-range filtering with startTime, endTime, availableSince
Troubleshooting failed or expired analytics queries

Delegate elsewhere when the user is:

Running standard CRM SOQL queries → platform-soql-query
Working with Data Cloud SQL or DMOs → retrieving-datacloud
Building reports/dashboards on standard objects → reporting skills
Deploying or retrieving generic metadata XML → deploying-metadata / retrieving-metadata

Available Types

AppAnalyticsQueryRequest (REST/sObject API)

An asynchronous query request that ISV partners use to retrieve usage analytics data for their managed packages from the ISV Intelligence Data Lake. Records are created via POST /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest and polled via GET /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest/<id>. The system processes the query and provides a presigned download URL upon completion.

Fields (14 properties):

Field	Type	Description
DataType	string (filterable)	Type of analytics data. Values: `PackageUsageSummary`, `PackageUsageLog`, `SubscriberSnapshot`
RequestState	string (filterable)	Processing status. Values: `New`, `Pending`, `Complete`, `Expired`, `Failed`, `NoData`, `Delivered`
StartTime	string	Start of time range for requested data
EndTime	string	End of time range. Should be set on an hour boundary
AvailableSince	string	Limits query to data indexed after this time (inclusive). Use for incremental retrieval
PackageIds	string	Comma-delimited list of managed package IDs (033-prefix)
OrganizationIds	string	Comma-delimited list of subscriber org IDs to filter results
DownloadUrl	string	Presigned URL for downloading results. Populated when RequestState is Complete
DownloadSize	long	Size in bytes of the result data file
DownloadExpirationTime	string	Time at which the download URL expires
FileType	string (filterable)	Output format. Values: `csv`, `parquet`
FileCompression	string (filterable)	Compression. Values: `none`, `gzip`, `snappy`
QuerySubmittedTime	string	Time the query was submitted to the Data Lake
ErrorMessage	string	Diagnostic message for failed queries

Show full SKILL.md (246 more words)Show less

AppAnalyticsSettings (Metadata API)

Configuration settings for ISV App Analytics that control simulation mode and opt-out behavior. Deployed via the Metadata API (sf project deploy) or Tooling API.

Fields (2 properties):

Field	Type	Description
enableSimulationMode	boolean (filterable)	When true, allows querying sample usage logs for integration testing without real subscriber data
enableAppAnalyticsOptOut	boolean (filterable)	When true, opts this subscriber org out of AppExchange App Analytics data collection

Request Lifecycle

text

New → Pending → Complete → (download within expiration window)
                         → Expired (download URL no longer valid)
                         → Delivered (download confirmed received)
         → Failed (check errorMessage)
         → NoData (no matching records for the criteria)

Common Patterns

Query Package Usage Summary (last 7 days)

Create a record via the REST API:

bash

POST /services/data/v60.0/sobjects/AppAnalyticsQueryRequest
Content-Type: application/json

{
  "DataType": "PackageUsageSummary",
  "StartTime": "<7-days-ago>T00:00:00Z",
  "EndTime": "<today-on-hour-boundary>T00:00:00Z",
  "PackageIds": "033XXXXXXXXXXXX",
  "FileType": "csv",
  "FileCompression": "gzip"
}

Poll the record via GET until RequestState reaches Complete, then download from DownloadUrl.

Incremental Data Retrieval

Set AvailableSince to the timestamp of your last successful query completion to avoid re-downloading data you already have.

Enable Simulation Mode for Testing

Deploy AppAnalyticsSettings via Metadata API with enableSimulationMode: true to query sample data without real subscribers.

High-Signal Gotchas

AppAnalyticsQueryRequest is an sObject — create and poll records via the REST Data API (/sobjects/AppAnalyticsQueryRequest), NOT via Metadata API XML deployment.
AppAnalyticsQueryRequest does NOT have Apex triggers and does NOT flow through custom objects or Flows.
Download URLs expire — always check DownloadExpirationTime before attempting download.
EndTime should be set on an hour boundary for consistent results.
AvailableSince is inclusive — data indexed at exactly that timestamp will be included.
PackageIds uses 033-prefix IDs, not 04t (package version) IDs.
Data is processed asynchronously by the ISV Intelligence Data Lake infrastructure. There is no synchronous query option.
FileType: parquet with FileCompression: snappy gives optimal performance for large datasets.

Output Format

text

Analytics task: <query / configure / troubleshoot>
Data type: <PackageUsageSummary / PackageUsageLog / SubscriberSnapshot>
Package IDs: <033-prefixed IDs>
Time range: <startTime> to <endTime>
File format: <csv|parquet> / <none|gzip|snappy>
Request state: <current state>
Next step: <poll for completion / download / investigate failure>

Files

Just SKILL.md in skills/dx-app-analytics-query of forcedotcom/sf-skills.

Open the folder on GitHubat commit 3c15867

Compare with similar skills

Dx App Analytics Query next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dx App Analytics Query compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Dx App Analytics Query this skillforcedotcom/sf-skills	1.1k	—	~1.7k	Automated safety check: Pass	Apache-2.0	5 days ago
Soql Lib Query Builderbeyond-the-cloud-dev/soql-lib	154	—	~4.3k	Automated safety check: Pass	MIT	4 days ago
Sf DatacloudJaganpro/sf-skills	424	—	~2.7k	Automated safety check: Pass	MIT	5 mo ago
Soql Lib Selectorbeyond-the-cloud-dev/soql-lib	154	—	~2k	Automated safety check: Pass	MIT	4 days ago
Dev SetupPortwood-Global-Solutions/Portwood	125	—	~1.1k	Automated safety check: Pass	Apache-2.0	2 days ago
Sf FlowJaganpro/sf-skills	424	—	~1.8k	Automated safety check: Pass	MIT	5 mo ago

Similar skills

Soql Lib Query Builder
beyond-the-cloud-dev/soql-lib
Builds Salesforce SOQL queries using the SOQL Lib fluent builder API (SOQL.cls).
154 GitHub stars~4.3k tokensUpdated 4 days ago
Sales & SupportAuto-check passed
Sf Datacloud
Jaganpro/sf-skills
Salesforce Data Cloud product orchestrator for connect→prepare→harmonize→segment→act workflows.
424 GitHub stars~2.7k tokensUpdated 5 mo ago
Sales & SupportAuto-check passed
Soql Lib Selector
beyond-the-cloud-dev/soql-lib
Creates Salesforce Apex selector classes using the SOQL Lib selector pattern.
154 GitHub stars~2k tokensUpdated 4 days ago
Sales & SupportAuto-check passed
Dev Setup
Portwood-Global-Solutions/Portwood
Get from a fresh clone of Portwood to a working, fully-tested Salesforce org.
125 GitHub stars~1.1k tokensUpdated 2 days ago
Sales & SupportAuto-check passed
Sf Flow
Jaganpro/sf-skills
Creates and validates Salesforce Flows with 110-point scoring.
424 GitHub stars~1.8k tokensUpdated 5 mo ago
Sales & SupportAuto-check passed
Google Maps Export
gmapsscraper/google-maps-agent-skills
Export Google Maps business data to CSV, JSON, or CRM format (HubSpot, Pipedrive, Salesforce).
131 GitHub stars~1.2k tokensUpdated 4 mo ago
Sales & SupportAuto-check passed

Questions about Dx App Analytics Query

What does Dx App Analytics Query do?

ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings. Dx App Analytics Query is an agent skill from forcedotcom/sf-skills. ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings.

When should I use Dx App Analytics Query?

Dx App Analytics Query fits situations like: the user asks about retrieving managed package usage data; configuring App Analytics simulation mode; querying subscriber snapshots; understanding the AppAnalyticsQueryRequest lifecycle (New → Pending → Complete → Expired).

How do I install Dx App Analytics Query in Claude Code?

Run `npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a claude-code`. Or copy the skill folder (skills/dx-app-analytics-query in forcedotcom/sf-skills) into .claude/skills/dx-app-analytics-query in your project. Claude Code loads it when a task matches its description.

How do I install Dx App Analytics Query in Codex?

Run `npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a codex`. Or copy the skill folder (skills/dx-app-analytics-query in forcedotcom/sf-skills) into .agents/skills/dx-app-analytics-query in your project. Codex loads it when a task matches its description.

Can I use Dx App Analytics Query in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add forcedotcom/sf-skills --skill dx-app-analytics-query -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dx-app-analytics-query, .gemini/skills/dx-app-analytics-query, .github/skills/dx-app-analytics-query and .opencode/skills/dx-app-analytics-query in your project.

What does Dx App Analytics Query need to run?

Going by SKILL.md and its folder, Dx App Analytics Query needs the command-line tools its instructions call (sf).

Does Dx App Analytics Query access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dx App Analytics Query safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dx App Analytics Query use?

Dx App Analytics Query is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dx App Analytics Query use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dx App Analytics Query?

Skills that share tags, products or a category with Dx App Analytics Query: Soql Lib Query Builder (beyond-the-cloud-dev/soql-lib, 154 stars), Sf Datacloud (Jaganpro/sf-skills, 424 stars), Soql Lib Selector (beyond-the-cloud-dev/soql-lib, 154 stars) and Dev Setup (Portwood-Global-Solutions/Portwood, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dx App Analytics Query?

forcedotcom (a GitHub organization) maintains it in forcedotcom/sf-skills, which has 1,058 GitHub stars. The repository holds 248 skills in this directory. The repository was last updated on October 3, 2026.

Source: forcedotcom/sf-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Dx App Analytics Query

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

App Analytics

When This Skill Owns the Task

Available Types

AppAnalyticsQueryRequest (REST/sObject API)

AppAnalyticsSettings (Metadata API)

Request Lifecycle

Common Patterns

Query Package Usage Summary (last 7 days)

Incremental Data Retrieval

Enable Simulation Mode for Testing

High-Signal Gotchas

Output Format

Files

Compare with similar skills

Similar skills

More from forcedotcom/sf-skills

Related

Questions about Dx App Analytics Query