Agent skill

Core Extension API

by forcedotcom in forcedotcom/salesforcedx-vscode

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

BSD-3-ClauseAuto-check passedSales & Support

Install Core Extension API

skills CLI
$ npx skills add forcedotcom/salesforcedx-vscode --skill core-extension-api -a claude-code

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

GitHub CLI
$ gh skill install forcedotcom/salesforcedx-vscode core-extension-api --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/core-extension-api .claude/skills/core-extension-api && 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
core-extension-api
GitHub stars
1k
Token cost
~842 tokens
SKILL.md length
202 words
Files
1
Skills in repo
37
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

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

  • Works in 6 steps: Read external-consumers → Grep monorepo: .exports.MEMBER — catches… → Search org → …
  • Modifying SalesforceVSCodeCoreApi
  • SKILL.md covers Public API — external…, API surface, Before changing and Consumer patterns
  • Calls gh

What it does

Core Extension API is an agent skill from forcedotcom/salesforcedx-vscode. Public API exported by salesforcedx-vscode-core activate(). Use when modifying SalesforceVSCodeCoreApi, the api object in activate(), exports from core index.ts, services sub-object, or evaluating whether a change to core is breaking. Also use when someone asks "does anything use X" for a core export.

Its SKILL.md is about 840 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. It works with Visual Studio Code and Salesforce. The repository describes itself as: Salesforce Extensions for VS Code. The licence is BSD-3-Clause.

When your agent uses it

  • Modifying SalesforceVSCodeCoreApi
  • The api object in activate()
  • Exports from core index.ts
  • Services sub-object

Example prompts

  • “does anything use X”
  • “/core-extension-api”

Workflow steps

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

  1. Read external-consumers
  2. Grep monorepo: .exports.MEMBER — catches direct access outside wrapper files
  3. Search org
  4. Read private repos: gh api repos/forcedotcom/REPO/contents/PATH --jq '.content' | base64 -d
  5. Removing something unused in monorepo? Confirm unused externally too
  6. Changing behavior? Check consumer version gates and minimum versions

What it can do on your machine

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

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Core Extension API loads about 842 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 202 words of instructions outside code blocks.

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

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 f7bb6fe, republished under its BSD-3-Clause licence (© forcedotcom). 202 words, ~842 tokens.

Download SKILL.mdSave it as .claude/skills/core-extension-api/SKILL.md (or your agent's skills folder).
name
core-extension-api
description
Public API exported by salesforcedx-vscode-core activate(). Use when modifying SalesforceVSCodeCoreApi, the api object in activate(), exports from core index.ts, services sub-object, or evaluating whether a change to core is breaking. Also use when someone asks "does anything use X" for a core export.
review
never

Core Extension Public API

packages/salesforcedx-vscode-core/src/index.ts — activate() returns SalesforceVSCodeCoreApi.

Consumers access via:

typescript
const ext = vscode.extensions.getExtension<SalesforceVSCodeCoreApi>(
  'salesforce.salesforcedx-vscode-core'
);
const api = ext.exports;

Also consumed indirectly via @salesforce/vscode-service-provider.

Public API — external consumers depend on this

See external-consumers for full list and search commands.

Breaking (check consumers first):

  • Remove field from SalesforceVSCodeCoreApi
  • Change field type
  • Change behavior (even same signature)
  • Change static methods on services.* classes (.getInstance())
  • Rename/restructure services sub-object

Non-breaking: add new fields.

API surface

Top-level (instances/functions)
workspaceContextUtils

WorkspaceContext is only services.WorkspaceContext, not a top-level activate() field.

Note: the top-level channelService field was removed (W-23348840). Consumers must use services.ChannelService.

Note: the top-level telemetryService field was removed (W-24265117). Callers use services.TelemetryService.getInstance or sf.vscode.core.get.telemetry.

Note: the top-level getUserId field was removed (W-24265117). No API replacement.

services (class constructors with static methods)
ChannelService (.getInstance(name)),
TelemetryService (.getInstance(name)),
WorkspaceContext (.getInstance()), CommandEventDispatcher (.getInstance())

External consumers predominantly use services.*. The .getInstance() signatures are public contract.

Before changing

  1. Read external-consumers
  2. Grep monorepo: \.exports\.MEMBER — catches direct access outside wrapper files
  3. Search org:
    bash
    gh api -X GET "search/code?q=SYMBOL+org:forcedotcom&per_page=30" \
      --jq '.items[] | "\(.repository.name): \(.path)"'
    # also search salesforcecli org
    gh api -X GET "search/code?q=SYMBOL+org:salesforcecli&per_page=30" \
      --jq '.items[] | "\(.repository.name): \(.path)"'
    # also search for exports.SYMBOL (direct access pattern)
    gh api -X GET "search/code?q=exports.SYMBOL+org:forcedotcom&per_page=30" \
      --jq '.items[] | "\(.repository.name): \(.path)"'
  4. Read private repos: gh api repos/forcedotcom/REPO/contents/PATH --jq '.content' | base64 -d
  5. Removing something unused in monorepo? Confirm unused externally too
  6. Changing behavior? Check consumer version gates and minimum versions

Consumer patterns

  • extensionDependencies: ["salesforce.salesforcedx-vscode-core"]
  • Version-check core (semver.satisfies(version, '>=X.Y.Z'))
  • Define own minimal type (don't import SalesforceVSCodeCoreApi directly)
  • Call .getInstance(extensionName) on services classes
  • Graceful degradation if core missing/outdated

© 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

Just SKILL.md in .claude/skills/core-extension-api of forcedotcom/salesforcedx-vscode.

Open the folder on GitHubat commit f7bb6fe

Compare with similar skills

Core Extension API 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.

Core Extension API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Core Extension API this skillforcedotcom/salesforcedx-vscode1k—~842Automated safety check: PassBSD-3-Clause
Experience Cms Brand Createforcedotcom/sf-skills1.1k—~2.8kAutomated safety check: PassApache-2.0
Sf ApexJaganpro/sf-skills424—~2kAutomated safety check: PassMIT
Sf DebugJaganpro/sf-skills424—~1.3kAutomated safety check: PassMIT
Experience UI Bundle Custom App Generateforcedotcom/sf-skills1.1k—~2.3kAutomated safety check: PassApache-2.0
Experience UI Bundle Mfa Configureforcedotcom/sf-skills1.1k—~4.8kAutomated safety check: PassApache-2.0

Similar skills

  • Experience Cms Brand Create

    forcedotcom/sf-skills

    Author a Salesforce Digital Experience brand (a "brand.json") so the VS Code Brand Toolkit can load, edit, and preview it.

    1.1k GitHub stars~2.8k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • Sf Apex

    Jaganpro/sf-skills

    Generates and reviews Salesforce Apex code with 150-point scoring.

    424 GitHub stars~2k tokensUpdated 5 mo ago
    Sales & SupportAuto-check passed
  • Sf Debug

    Jaganpro/sf-skills

    Salesforce debug log analysis and troubleshooting with 100-point scoring.

    424 GitHub stars~1.3k tokensUpdated 5 mo ago
    Sales & SupportAuto-check passed
  • MUST activate when the project contains a uiBundles//src/ directory and the task involves creating or configuring a Custom Application for hosting a UI bundle in Lightning Experience.

    1.1k GitHub stars~2.3k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • Configure Multi-Factor Authentication (MFA) for Salesforce Experience Site users.

    1.1k GitHub stars~4.8k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • Platform Apex Logs Debug

    forcedotcom/sf-skills

    Salesforce debug log analysis and troubleshooting with 100-point scoring.

    1.1k GitHub stars~1.9k tokensUpdated 4 days ago
    Sales & SupportAuto-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
  • 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
  • External Consumers

    forcedotcom/salesforcedx-vscode

    Known external consumers of APIs from this monorepo's extensions.

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

Categories

Questions about Core Extension API

What does Core Extension API do?

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

When should I use Core Extension API?

Core Extension API fits situations like: modifying SalesforceVSCodeCoreApi; the api object in activate(); exports from core index.ts; services sub-object.

How do I install Core Extension API in Claude Code?

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

How do I install Core Extension API in Codex?

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

Can I use Core Extension API 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 core-extension-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/core-extension-api, .gemini/skills/core-extension-api, .github/skills/core-extension-api and .opencode/skills/core-extension-api in your project.

What does Core Extension API need to run?

Going by SKILL.md and its folder, Core Extension API needs the command-line tools its instructions call (gh).

Does Core Extension API access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Core Extension API 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 Core Extension API use?

Core Extension API 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 Core Extension API use?

About 842 tokens (SKILL.md is roughly 3.4k 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 Core Extension API?

Skills that share tags, products or a category with Core Extension API: Experience Cms Brand Create (forcedotcom/sf-skills, 1.1k stars), Sf Apex (Jaganpro/sf-skills, 424 stars), Sf Debug (Jaganpro/sf-skills, 424 stars) and Experience UI Bundle Custom App Generate (forcedotcom/sf-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Core Extension API?

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 7, 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.