Agent skill

Query App Insights

by forcedotcom in forcedotcom/salesforcedx-vscode

Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics

BSD-3-ClauseAuto-check passedBusiness, Finance & HR

Install Query App Insights

skills CLI
$ npx skills add forcedotcom/salesforcedx-vscode --skill query-app-insights -a claude-code

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

GitHub CLI
$ gh skill install forcedotcom/salesforcedx-vscode query-app-insights --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/salesforcedx-vscode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/query-app-insights .claude/skills/query-app-insights && 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/

Facts

Skill name
query-app-insights
GitHub stars
1k
Token cost
~436 tokens
SKILL.md length
168 words
Files
4 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics

  • Works in 7 steps: Validate credentials - check env vars… → Test API - tsx… → Interpret question - identify commands,… → …
  • Tasks that involve OKRs and executive reporting
  • SKILL.md covers Prerequisites, Workflow, Key Points and References
  • Calls tsx; needs APP_INSIGHTS_API_KEY

What it does

Query App Insights is an agent skill from forcedotcom/salesforcedx-vscode. Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/command-id-vs-executor.md`, `references/query-patterns.md` and `references/script.md`).

It sits in Business, Finance & HR, covering OKRs and executive reporting. It works with Azure Monitor, OpenTelemetry and Microsoft Sentinel. The repository describes itself as: Salesforce Extensions for VS Code. The licence is BSD-3-Clause.

When your agent uses it

  • Tasks that involve OKRs and executive reporting

Example prompts

  • “/query-app-insights”

Requirements

  • A credential in APP_INSIGHTS_API_KEY

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Validate credentials - check env vars exist
  2. Test API - tsx scripts/queryAppInsights.ts "customEvents | take 1"
  3. Interpret question - identify commands, extensions, time ranges, metrics
  4. Find executor name - if checking a command, find its executor name (see references)
  5. Build KQL query - use executor names, not command IDs
  6. Execute - tsx scripts/queryAppInsights.ts ""
  7. Answer - interpret results, format clearly

What it can do on your machine

Read from SKILL.md and the folder at commit 27807f6. 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:

    • tsx

    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 these keys or tokens, usually read from environment variables:

    • APP_INSIGHTS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Query App Insights loads about 436 tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 168 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~436
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.4k

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/salesforcedx-vscode at commit 27807f6, republished under its BSD-3-Clause licence (© forcedotcom). 168 words, ~436 tokens.

Download SKILL.mdSave it as .claude/skills/query-app-insights/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
query-app-insights
description
Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics
review
never
disable-model-invocation
true

Query App Insights

Query Azure Application Insights telemetry to answer questions about command usage, extension activity, performance.

Prerequisites

  • APP_INSIGHTS_API_KEY env var
  • APP_INSIGHTS_CLIENT_ID env var

Workflow

  1. Validate credentials - check env vars exist
  2. Test API - tsx scripts/queryAppInsights.ts "customEvents | take 1"
  3. Interpret question - identify commands, extensions, time ranges, metrics
  4. Find executor name - if checking a command, find its executor name (see references)
  5. Build KQL query - use executor names, not command IDs
  6. Execute - tsx scripts/queryAppInsights.ts "<kql-query>"
  7. Answer - interpret results, format clearly

Key Points

  • Telemetry uses executor names, not command IDs
  • Event pattern: ends with /commandExecution (Legacy/v2) or stored in dependencies table (OTEL/v3)
  • Tables: customEvents (Legacy), dependencies (OTEL Spans), requests (Root Spans)
  • OTEL Properties: name (Span name), cloud_RoleName (Extension name), operation_Id (Trace ID), operation_ParentId (Parent Span ID)
  • OTEL Root Filter: where operation_ParentId == operation_Id (Finds top-level spans in v3)
  • Measurements: customMeasurements.executionTime (ms for Legacy) or duration (ms for OTEL)

References

  • references/command-id-vs-executor.md - Finding executor names, shared executors, commands without telemetry
  • references/query-patterns.md - Common KQL patterns
  • references/script.md - Script implementation details

© forcedotcom, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .claude/skills/query-app-insights of forcedotcom/salesforcedx-vscode.

  • SKILL.md
  • references/command-id-vs-executor.md
  • references/query-patterns.md
  • references/script.md

Open the folder on GitHubat commit 27807f6

Compare with similar skills

Query App Insights 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.

Query App Insights compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Query App Insights this skillforcedotcom/salesforcedx-vscode1k—~436Automated safety check: PassBSD-3-Clause
Analytics Strategyrampstackco/claude-skills9401 repos~2.4kAutomated safety check: PassMIT
Pine BacktesterTradersPost/pinescript-agents1701 repos~3.9kAutomated safety check: PassNone
Onboarding Plannerbpinheiroms/dotfiles108—~5.4kAutomated safety check: PassNone
Replit Decksanqiufong/slides-from-anything1321 repos~2.9kAutomated safety check: PassApache-2.0
Building Streamlit Dashboardsiusztinpaul/designing-real-world-ai-agents-workshop513—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    940 GitHub starsUsed in 1 repo~2.4k tokens
    Business, Finance & HRAuto-check passed
  • Pine Backtester

    TradersPost/pinescript-agents

    Implements comprehensive backtesting and performance metrics.

    170 GitHub starsUsed in 1 repo~3.9k tokens
    Business, Finance & HRAuto-check passed
  • Onboarding Planner

    bpinheiroms/dotfiles

    Plan high-conversion mobile app onboarding flows from scratch.

    108 GitHub stars~5.4k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Replit Deck

    sanqiufong/slides-from-anything

    Single-file horizontal-swipe HTML deck in the style of Replit Slides's landing-page template gallery.

    132 GitHub starsUsed in 1 repo~2.9k tokens
    Business, Finance & HRAuto-check passed
  • Building Streamlit Dashboards

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building dashboards in Streamlit. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    513 GitHub stars~1.1k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Massing Bim

    ibuilder/massing

    Drive a Massing BIM/AEC project from an AI agent over MCP — read a project's status, records, CDE, KPI and model-quality checks; run standards-compliance, schedule-risk, embodied-carbon, permit-…

    122 GitHub stars~1.1k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed

More from forcedotcom/salesforcedx-vscode

All 37 skills in this repo
  • Command UI

    forcedotcom/salesforcedx-vscode

    Command palette, CodeLens, context menus, package.nls titles, and NotificationModeService.

    1k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Services Extension Consumption

    forcedotcom/salesforcedx-vscode

    Consume the salesforcedx-vscode-services extension API. An agent skill from forcedotcom/salesforcedx-vscode.

    1k GitHub stars~5k tokensUpdated today
    Auto-check passed
  • Changelog

    forcedotcom/salesforcedx-vscode

    Polish the automated CHANGELOG on develop before the next stable build.

    1k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Core Extension API

    forcedotcom/salesforcedx-vscode

    Public API exported by salesforcedx-vscode-core activate(). An agent skill from forcedotcom/salesforcedx-vscode.

    1k GitHub stars~842 tokensUpdated today
    Auto-check passed
  • Drivable Vscode

    forcedotcom/salesforcedx-vscode

    Operate a real VS Code instance through drivable-vscode. An agent skill from forcedotcom/salesforcedx-vscode.

    1k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Effect Best Practices

    forcedotcom/salesforcedx-vscode

    Enforces Effect-TS patterns for services, errors, layers, atoms, and Effect.pipe composition.

    1k GitHub stars~6.2k tokensUpdated today
    Auto-check passed

Questions about Query App Insights

What does Query App Insights do?

Query Azure Application Insights telemetry data for command usage, extension activity, and performance metrics. Query App Insights is an agent skill from forcedotcom/salesforcedx-vscode.

When should I use Query App Insights?

Query App Insights fits situations like: tasks that involve OKRs and executive reporting.

How do I install Query App Insights in Claude Code?

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

How do I install Query App Insights in Codex?

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

Can I use Query App Insights 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/salesforcedx-vscode --skill query-app-insights -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/query-app-insights, .gemini/skills/query-app-insights, .github/skills/query-app-insights and .opencode/skills/query-app-insights in your project.

What does Query App Insights need to run?

Going by SKILL.md and its folder, Query App Insights needs the command-line tools its instructions call (tsx) and credentials named APP_INSIGHTS_API_KEY. Our summary lists: A credential in APP_INSIGHTS_API_KEY.

Does Query App Insights 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 Query App Insights 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 Query App Insights use?

Query App Insights is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Query App Insights use?

About 436 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Query App Insights?

Skills that share tags, products or a category with Query App Insights: Analytics Strategy (rampstackco/claude-skills, 940 stars), Pine Backtester (TradersPost/pinescript-agents, 170 stars), Onboarding Planner (bpinheiroms/dotfiles, 108 stars) and Replit Deck (sanqiufong/slides-from-anything, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Query App Insights?

forcedotcom (a GitHub organization) maintains it in forcedotcom/salesforcedx-vscode, which has 1,035 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 8, 2026.

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