Agent skill

Vscode Sfdx Hardis

by hardisgroupcom in hardisgroupcom/sfdx-hardis

How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output…

AGPL-3.0Auto-check passedBackend & APIs

Install Vscode Sfdx Hardis

skills CLI
$ npx skills add hardisgroupcom/sfdx-hardis --skill vscode-sfdx-hardis -a claude-code

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

GitHub CLI
$ gh skill install hardisgroupcom/sfdx-hardis vscode-sfdx-hardis --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/hardisgroupcom/sfdx-hardis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/vscode-sfdx-hardis .claude/skills/vscode-sfdx-hardis && 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
vscode-sfdx-hardis
GitHub stars
402
Token cost
~2.3k tokens
SKILL.md length
901 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
AGPL-3.0

At a glance

How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output…

  • Works in 5 steps: Same feature, same behavior. When a… → Flags, JSON fields and events are an… → Minimum CLI version. When the extension… → …
  • Tasks that involve Realtime and WebSockets
  • SKILL.md covers When a task has an extension…, Integration surface, Rules and Working on the extension side, plus 1 more section
  • Calls yarn and sf

What it does

Vscode Sfdx Hardis is an agent skill from hardisgroupcom/sfdx-hardis. How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output, WebSocket messages, config schema, command list, report files, doc screenshots), or when a request mentions VS Code, the extension, a panel, an LWC or the DevOps Pipeline. Load it before analyzing, designing, implementing or testing such a change.

Its SKILL.md is about 2.3k 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 Backend & APIs, covering Realtime and WebSockets. It works with Visual Studio Code and Salesforce. The repository describes itself as: French-army-knife Toolbox for Salesforce. Orchestrates base commands and assist users with interactive wizards to make much more than native Salesforce CLI + Allows you to define…. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Realtime and WebSockets

Example prompts

  • “/vscode-sfdx-hardis”

Workflow steps

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

  1. Same feature, same behavior. When a feature can be run from the terminal and from a panel, the CLI is the only engine. The panel reads…
  2. Flags, JSON fields and events are an API. Renaming or removing one breaks the extensions already installed. Add, deprecate, then remove.
  3. Minimum CLI version. When the extension starts using a new flag, command or JSON field, raise RECOMMENDED_MINIMAL_SFDX_HARDIS_VERSION in…
  4. Schema first. A config property the extension edits must be merged in config/sfdx-hardis.jsonschema.json on sfdx-hardis main before yarn…
  5. Two pull requests, linked. Use the same branch name in both repositories, open one PR in each, link each description to the other, and add…

What it can do on your machine

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

    • yarn
    • sf

    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

Vscode Sfdx Hardis loads about 2.3k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 901 words of instructions outside code blocks.

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

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 hardisgroupcom/sfdx-hardis at commit 33d4de0, republished under its AGPL-3.0 licence (© hardisgroupcom). 901 words, ~2,321 tokens.

Download SKILL.mdSave it as .claude/skills/vscode-sfdx-hardis/SKILL.md (or your agent's skills folder).
name
vscode-sfdx-hardis
description
How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output, WebSocket messages, config schema, command list, report files, doc screenshots), or when a request mentions VS Code, the extension, a panel, an LWC or the DevOps Pipeline. Load it before analyzing, designing, implementing or testing such a change.

vscode-sfdx-hardis (VS Code extension)

The extension is how most users run sfdx-hardis. It lives in its own repository:

It runs the CLI (sf hardis:...) and talks with it over a WebSocket. A change made here without looking at the extension ships a broken or outdated UI.

When a task has an extension impact

The extension is in scope as soon as one of these is true:

  • The request names VS Code, the extension, a panel, an LWC, the DevOps Pipeline, the Welcome page, the commands tree or a UI.
  • A command's flags, prompts, defaults, --json output or --agent behavior change: the extension launches commands with flags and reads their JSON results.
  • A prompts() call is added, removed or changes type: the extension renders every prompt in the command runner.
  • A WebSocketClient message is added or changed (src/common/websocketClient.ts).
  • A config property is added or changed in config/sfdx-hardis.jsonschema.json: the extension copies this schema and builds its settings editors from it.
  • A command is added, renamed or removed: the extension lists commands in its tree, and some LWC cards launch them.
  • A feature exists on both sides (backpromote, promotion branches, monitoring config, metadata retriever, org manager...): both must behave the same.

When in doubt, grep the extension for the command id, the flag, the config key or the event name.

Integration surface

sfdx-hardisvscode-sfdx-hardis
WebSocketClient.send* messages (event: '...') in src/common/websocketClient.tssrc/hardis-websocket-server.ts, one data.event === "..." branch per event
prompts() (src/common/utils/prompts.ts)prompts event, rendered in the command runner (s/commandExecution) or the s-prompt-input panel
uxLog('action', ...), uxLogTable, WebSocketClient.sendReportFileMessageCommand runner timeline: visible log lines, tables (20 rows at most), report buttons
WebSocketClient.sendVscodeDiffMessagevscodeDiff event, opens vscode.diff editors
sendRefreshPipelineMessage, sendRefreshStatusMessage, sendRefreshCommandsMessageRefresh of the DevOps Pipeline, the status tree and the commands tree
config/sfdx-hardis.jsonschema.jsonresources/sfdx-hardis.jsonschema.json via yarn sync:schema (reads main), editors in src/utils/pipeline/sfdxHardisConfigHelper.ts
src/common/metadata-utils/metadataList.tsyarn sync:metadata-list (reads main)
Commands, their flags and their --json outputexecSfdxJson() / execCommandWithProgress() calls, src/hardis-commands-provider.ts, LWC runCommand messages
Read-only JSON commands meant for a UI (hardis:config:monitoring-defaults)Panels that load data first, then run the real command (src/utils/monitoringConfigUtils.ts)
colorClass values of categories, notifications and commandsTile hues of the LWC catalogs: the CLI sets them, the extension reads them
Extension screenshots in docs/assets/imagesyarn screenshots regenerates them and copies them into this repository. On Windows it shows no window (VS Code runs on a desktop of its own) and can run in the background; on macOS and Linux a window opens, ask first
src/i18n/*.json (CLI messages shown in the command runner)Its own src/i18n/*.json for the extension labels, same 9 locales, case-sensitive key order

Rules

  1. Same feature, same behavior. When a feature can be run from the terminal and from a panel, the CLI is the only engine. The panel reads what it needs from a read-only command (--json), then runs the real command with explicit flags (usually with --agent). Every choice a panel offers exists as a CLI flag, and every terminal prompt fills the same option. Never reimplement CLI logic in the extension.
  2. Flags, JSON fields and events are an API. Renaming or removing one breaks the extensions already installed. Add, deprecate, then remove.
  3. Minimum CLI version. When the extension starts using a new flag, command or JSON field, raise RECOMMENDED_MINIMAL_SFDX_HARDIS_VERSION in the extension's src/constants.ts to the sfdx-hardis version that ships it.
  4. Schema first. A config property the extension edits must be merged in config/sfdx-hardis.jsonschema.json on sfdx-hardis main before yarn sync:schema can pick it up.
  5. Two pull requests, linked. Use the same branch name in both repositories, open one PR in each, link each description to the other, and add a CHANGELOG entry in each (## [beta] (main) here, ## Unreleased there).
Show full SKILL.md (274 more words)Show less

Working on the extension side

The extension has its own agent setup. For every file under vscode-sfdx-hardis, read and follow it instead of the sfdx-hardis conventions:

  • vscode-sfdx-hardis/CLAUDE.md: build commands, architecture, LWC and styling rules (theme-aware resources/global-theme.css kit, no hardcoded colors, s-hardis-datatable, tinted neutral buttons), i18n key order, panel performance rules.
  • vscode-sfdx-hardis/.claude/skills/: analyze, design, implement, test, document, pr-watch-fix, megalinter, megalinter-check, megalinter-fix, megalinter-setup, fix-duplicate, fix-security, monitoring.
  • vscode-sfdx-hardis/.claude/agents/: analyze, design, implement, test, document, pr-fix, pr-watch, and the MegaLinter agents.

Each phase of the sfdx-hardis workflow has its extension counterpart:

Phasesfdx-hardisvscode-sfdx-hardis
Analyzeanalyze skill / agentanalyze skill: entry points, panels, message flow
Designdesign skill / agentdesign skill: execution mode, message types, i18n keys, styling, loading state
Implementimplement skill / agentimplement skill: LWC patterns, kit classes, i18n in 9 locales, CHANGELOG ## Unreleased
Testtest skill / agenttest skill: yarn lint, yarn dev, yarn compile, yarn test, and yarn test:ui for panels and tree views

A sub-agent started from this repository only loads the sfdx-hardis instructions. When delegating extension work, point the sub-agent at the extension folder and tell it to read the extension's CLAUDE.md and the matching skill before touching anything.

Checklist

  • Grepped the extension for the command ids, flags, config keys and event names the change touches.
  • Wrote the extension impact in the analysis and in the design, or "none" with the reason.
  • CLI flags cover every choice the UI offers, and the UI passes them instead of duplicating logic.
  • Extension changes follow its CLAUDE.md and skills, and pass its lint, build and tests.
  • RECOMMENDED_MINIMAL_SFDX_HARDIS_VERSION raised when the extension needs the new CLI.
  • One PR per repository, cross-linked, with a CHANGELOG entry in each.

© hardisgroupcom, AGPL-3.0. 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/vscode-sfdx-hardis of hardisgroupcom/sfdx-hardis.

Open the folder on GitHubat commit 33d4de0

Compare with similar skills

Vscode Sfdx Hardis 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.

Vscode Sfdx Hardis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vscode Sfdx Hardis this skillhardisgroupcom/sfdx-hardis402—~2.3kAutomated safety check: PassAGPL-3.0
Azure Messaging Webpubsubservice Pymicrosoft/skills3.1k5 repos~2kAutomated safety check: PassMIT
Azure AI Voicelive Pymicrosoft/skills3.1k—~2.9kAutomated safety check: PassMIT
Knowledge Interaction Surfaces Vscode BridgeechoVic/blade-code181—~975Automated safety check: PassMIT
Services Extension Consumptionforcedotcom/salesforcedx-vscode1k—~5kAutomated safety check: PassBSD-3-Clause
Changelog Entrycertinia/debug-log-analyzer114—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Official

    Azure Web PubSub Service SDK for Python. An agent skill from microsoft/skills.

    3.1k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check passed
  • Azure AI Voicelive Py

    microsoft/skills

    Official

    Build real-time voice AI applications using Azure AI Voice Live SDK (azure-ai-voicelive).

    3.1k GitHub stars~2.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • 覆盖 Blade VS Code 扩展的激活、WebSocket RPC、端口发现、编辑器/选区/诊断/Diff 操作和扩展打包。进入时机:修改 IDE 桥协议、/ide 连接、状态栏、端口文件、VS Code 命令或 VSIX 构建。

    181 GitHub stars~975 tokensUpdated 12 days ago
    Backend & APIsAuto-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
    Sales & SupportAuto-check passed
  • Changelog Entry

    certinia/debug-log-analyzer

    Write, review or trim CHANGELOG.md entries. An agent skill from certinia/debug-log-analyzer.

    114 GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-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
    Sales & SupportAuto-check passed

More from hardisgroupcom/sfdx-hardis

All 21 skills in this repo
  • sfdx-hardis Training End-to-End Test

    hardisgroupcom/sfdx-hardis

    Walks the sfdx-hardis training course end to end as a learner would, against a real Developer Edition org and fork, fixing broken steps and screenshots that no longer match.

    402 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Promotion Branches E2E Test

    hardisgroupcom/sfdx-hardis

    Runs a full end-to-end test of sfdx-hardis promotion branches and backpromote against real Salesforce orgs and a throwaway repository, then writes a report.

    402 GitHub stars~11k tokensUpdated today
    Auto-check: notes
  • sfdx-hardis Architecture Guide

    hardisgroupcom/sfdx-hardis

    Explains how the sfdx-hardis Salesforce CLI plugin is built: its TypeScript and Oclif stack, command layout, agent-mode flag and provider classes for git, notifications and AI.

    402 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Changelog Style Rules

    hardisgroupcom/sfdx-hardis

    Style rules for adding CHANGELOG.md entries: short, user-facing bullets grouped by command under the beta section, each linking the command's docs page.

    402 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Documentation

    hardisgroupcom/sfdx-hardis

    Documentation standards for sfdx-hardis commands (description format with Command Behavior and Technical explanations sections, MkDocs site, build:doc).

    402 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Fix Jscpd

    hardisgroupcom/sfdx-hardis

    Decision framework for fixing jscpd (copy-paste detector) errors.

    402 GitHub stars~613 tokensUpdated today
    Auto-check passed

Categories

Questions about Vscode Sfdx Hardis

What does Vscode Sfdx Hardis do?

How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output…. Vscode Sfdx Hardis is an agent skill from hardisgroupcom/sfdx-hardis. How sfdx-hardis and its VS Code extension vscode-sfdx-hardis depend on each other, and the checklist to apply whenever a change here can affect the extension (command flags, prompts, --json output, WebSocket messages, config schema, command list, report files, doc screenshots), or when a request mentions VS Code, the extension, a panel, an LWC or the DevOps Pipeline.

When should I use Vscode Sfdx Hardis?

Vscode Sfdx Hardis fits situations like: tasks that involve Realtime and WebSockets.

How do I install Vscode Sfdx Hardis in Claude Code?

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

How do I install Vscode Sfdx Hardis in Codex?

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

Can I use Vscode Sfdx Hardis 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 hardisgroupcom/sfdx-hardis --skill vscode-sfdx-hardis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vscode-sfdx-hardis, .gemini/skills/vscode-sfdx-hardis, .github/skills/vscode-sfdx-hardis and .opencode/skills/vscode-sfdx-hardis in your project.

What does Vscode Sfdx Hardis need to run?

Going by SKILL.md and its folder, Vscode Sfdx Hardis needs the command-line tools its instructions call (yarn and sf).

Does Vscode Sfdx Hardis 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 Vscode Sfdx Hardis 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 Vscode Sfdx Hardis use?

Vscode Sfdx Hardis is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vscode Sfdx Hardis use?

About 2.3k tokens (SKILL.md is roughly 9.3k 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 Vscode Sfdx Hardis?

Skills that share tags, products or a category with Vscode Sfdx Hardis: Azure Messaging Webpubsubservice Py (microsoft/skills, 3.1k stars), Azure AI Voicelive Py (microsoft/skills, 3.1k stars), Knowledge Interaction Surfaces Vscode Bridge (echoVic/blade-code, 181 stars) and Services Extension Consumption (forcedotcom/salesforcedx-vscode, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vscode Sfdx Hardis?

hardisgroupcom (a GitHub organization) maintains it in hardisgroupcom/sfdx-hardis, which has 402 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.

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