dx-app-analytics-queryAnalytics, an agent skill published by forcedotcom/sf-skills

Analytics

forcedotcom/sf-skillsskills.sh ↗

Installs

4,913

deduplicated, at the last sync

Since we started

+11.5%

40 readings, about 2 hours apart. Not a live curve.

Our category

Analytics

ours

Last read

Sep 5, 2026

from the directory

Our brief

ours

This skill assists ISV partners by providing tools to query managed package usage data from the ISV Intelligence Data Lake. It allows users to create asynchronous `AppAnalyticsQueryRequest` records via the REST/sObject API, configure App Analytics settings using the Metadata API (such as enabling simulation mode), and track the entire query lifecycle.

What it produces
  • Presigned download URL for result data
  • Structured analytics task summary
What it needs
  • AppAnalytics metadata types
Paid services

not detected

The evidence describes using the REST/sObject API and Metadata API but does not specify any requirements regarding paid plans or APIs.

Registration

not detected

The evidence does not provide information about whether user registration is required to use this skill.

Limits and human review

The skill cannot handle standard CRM SOQL queries, general reporting/dashboard building, or deploying generic metadata XML. It also handles data asynchronously and requires users to check the download URL expiration time.

Evidenceskills/dx-app-analytics-query/SKILL.md:1-142
skills/dx-app-analytics-query/SKILL.md1–142
---
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 platform-soql-query)."
metadata:
  cliTools:
    - tool: ["sf"]
      semver: ">=2.0.0"
  relatedSkills:
    - "platform-metadata-deploy"
    - "platform-soql-query"
  version: "1.0"
  domains: ["Developer Experience"]
  minApiVersion: "56.0"
---

# 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 mod

Read 1 of 1 text files in the skill.

Checked September 2026 · GemmaWritten from the skill's published files. Check the source before relying on access or cost details.

Installfrom the directory

npx skills add https://github.com/forcedotcom/sf-skills

Installing happens there, not here. We are an index with an opinion, not a mirror.

What is inside itfrom the directory

SKILL.md

1 files — names only. The directory does not report sizes.

What the auditors foundfrom the directory

A skill is instructions your agent will follow and scripts it may run, so who checked it matters as much as how many people installed it.

Gen Agent Trust HubThis skill provides documentation and common patterns for working with Salesforce ISV App Analytics. It covers querying usage data and configuring settings via official APIs and CLI tools. No security risks were identified.Aug 26, 2026 · SAFEpass
SocketNo alertsAug 26, 2026pass
SnykRisk: LOW · No issuesAug 26, 2026 · LOWpass

Installs, reading by readingours

4.4k
4.9k
Aug 30, 202640 readings over 6 days, drawn as the last reading of each day.Sep 5, 2026

Axis starts at 4.4k, not zero — the range is 4.4k to 4.9k.

Asked out loudspoken, not typed

The same skill in the words people use speaking to an assistant rather than typing into a box. Each one carries the situation it came from, and each answer says only what the skill's own files support.

needing dataHow do I query usage analytics data for my managed package?

You can use this skill to create an asynchronous `AppAnalyticsQueryRequest` record via the REST API. You will need to specify parameters like the data type, time range, and package IDs.

checking costsDo I have to pay for using this skill?

The evidence describes using the REST/sObject API and Metadata API but does not specify any requirements regarding paid plans or APIs.

troubleshooting a requestWhat if my analytics query fails to complete?

You should monitor the record's `RequestState` for failure, and check the `ErrorMessage` field on the record for diagnostic details.

Filed alongside itours