Keep the installed Shopify skill up to date daily

[alfonso-noriega]

WHY are these changes introduced?

Fixes #0000

WHAT is this pull request doing?

How to test your changes?

Post-release steps

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes
• I've considered analytics changes to measure impact
• The change is user-facing — I've identified the correct bump type (patch for bug fixes · minor for new features · major for breaking changes) and added a changeset with pnpm changeset add

[alfonso-noriega]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Announce background skill updates on the next CLI run #8166
• Keep the installed Shopify skill up to date daily #8164 👈 (View in Graphite)
• Auto-install the Shopify skill in the background on CLI runs #8160
• Add Shopify skill install command #8140
• Add shopify validate, the unified Shopify skill, and per-topic agent files #8142
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[alfonso-noriega]

/snapit

[github-actions]

🫰✨ Thanks @alfonso-noriega! Your snapshot has been published to npm.

Test the snapshot by installing your package globally:

pnpm i -g --@shopify:registry=https://registry.npmjs.org @shopify/cli@0.0.0-snapshot-20260723193923

Caution

After installing, validate the version by running shopify version in your terminal.
If the versions don't match, you might have multiple global instances installed.
Use which shopify to find out which one you are running and uninstall it.

[alfonso-noriega]

/snapit

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

packages/cli-kit/dist/public/node/skills.d.ts

import { LocalStorage } from './local-storage.js';
import { ConfSchema } from '../../private/node/conf-store.js';
/**
 * Options for {@link promptShopifySkillInstallIfNeeded}.
 */
export interface PromptShopifySkillInstallOptions {
    /** The command being run, used to avoid prompting recursively from `skill` commands. */
    currentCommand: string;
    /** The arguments of the command being run, used to avoid corrupting `--json` output. */
    args?: string[];
    /** The process argv, used to re-invoke the current CLI binary. */
    argv?: string[];
    /** The process environment. */
    env?: NodeJS.ProcessEnv;
    /** The cli-kit local storage, injectable for testing. */
    config?: LocalStorage<ConfSchema>;
    /** The user's home directory, injectable for testing. */
    homeDir?: string;
}
/**
 * Checks whether the Shopify skill for coding agents is installed globally.
 *
 * The skills CLI installs universal skills under `~/.agents/skills` (older versions)
 * or `$XDG_CONFIG_HOME/agents/skills` (newer versions), so both locations are checked.
 *
 * @param env - The process environment.
 * @param homeDir - The user's home directory.
 * @returns Whether the Shopify skill is installed in any known global location.
 */
export declare function shopifySkillIsInstalled(env?: NodeJS.ProcessEnv, homeDir?: string): boolean;
/**
 * The outcome of a Shopify skill update check.
 */
export type ShopifySkillUpdateResult = 'updated' | 'already-up-to-date' | 'not-installed';
/**
 * Options for {@link updateShopifySkill}.
 */
export interface UpdateShopifySkillOptions {
    /** The process environment. */
    env?: NodeJS.ProcessEnv;
    /** The user's home directory, injectable for testing. */
    homeDir?: string;
}
/**
 * Updates the installed Shopify skill when its remote source has changed.
 *
 * Fetches the skill source and compares it with the installed universal skill
 * file, writing it over only when the content differs. The installed file is
 * the only state involved, and updating it propagates to every agent through
 * the symlinks created at install time.
 *
 * @param options - See {@link UpdateShopifySkillOptions}.
 * @returns The outcome of the update check.
 */
export declare function updateShopifySkill(options?: UpdateShopifySkillOptions): Promise<ShopifySkillUpdateResult>;
/**
 * Options for {@link updateShopifySkillIfNeeded}.
 */
export interface UpdateShopifySkillIfNeededOptions {
    /** The command being run, used to avoid updating recursively from `skill` commands. */
    currentCommand: string;
    /** The process environment. */
    env?: NodeJS.ProcessEnv;
    /** The cli-kit local storage, injectable for testing. */
    config?: LocalStorage<ConfSchema>;
    /** The user's home directory, injectable for testing. */
    homeDir?: string;
}
/**
 * Keeps an installed Shopify skill up to date, checking the remote source at most
 * once per day. The check runs inline: a tightly time-boxed fetch compares the
 * source with the installed skill, rewrites it when it changed, and announces the
 * update immediately. Failures are logged and retried a day later.
 *
 * Skipped when the skill is not installed (the install prompt owns that case),
 * for `skill` commands (to avoid recursion), in CI, in unit tests, in development
 * mode, and when `SHOPIFY_CLI_NO_SKILL_AUTO_UPDATE` is set.
 *
 * @param options - See {@link UpdateShopifySkillIfNeededOptions}.
 */
export declare function updateShopifySkillIfNeeded(options: UpdateShopifySkillIfNeededOptions): Promise<void>;
/**
 * Asks the user whether to install the Shopify skill for coding agents when it
 * isn't installed yet. Selecting yes runs `shopify skill install` in a detached
 * background process, so the current command is never delayed.
 *
 * The prompt is shown at most once per day, and never again once the skill is
 * detected as installed or the user opts out, so deliberately uninstalling the
 * skill won't trigger new prompts.
 *
 * Skipped for `skill` commands (to avoid recursion), for `--json` output, in
 * non-interactive terminals, in CI, in unit tests, in development mode, and
 * when `SHOPIFY_CLI_NO_SKILL_INSTALL_PROMPT` is set.
 *
 * @param options - See {@link PromptShopifySkillInstallOptions}.
 */
export declare function promptShopifySkillInstallIfNeeded(options: PromptShopifySkillInstallOptions): Promise<void>;

Existing type declarations

packages/cli-kit/dist/private/node/conf-store.d.ts

@@ -25,6 +25,7 @@ export interface ConfSchema {
     currentDevSessionId?: string;
     cache?: Cache;
     autoUpgradeEnabled?: boolean;
+    skillInstallPromptDismissed?: boolean;
 }
 /**
  * Get session.
@@ -139,6 +140,20 @@ export declare function getAutoUpgradeEnabled(config?: LocalStorage<ConfSchema>)
  * @param enabled - Whether auto-upgrade should be enabled.
  */
 export declare function setAutoUpgradeEnabled(enabled: boolean, config?: LocalStorage<ConfSchema>): void;
+/**
+ * Get whether the Shopify skill install prompt has been dismissed, either because
+ * the skill was detected as installed or because the user opted out.
+ *
+ * @param config - The cli-kit local storage.
+ * @returns Whether the skill install prompt should never be shown again.
+ */
+export declare function getSkillInstallPromptDismissed(config?: LocalStorage<ConfSchema>): boolean;
+/**
+ * Record that the Shopify skill install prompt should never be shown again.
+ *
+ * @param config - The cli-kit local storage.
+ */
+export declare function setSkillInstallPromptDismissed(config?: LocalStorage<ConfSchema>): void;
 export declare function getConfigStoreForPartnerStatus(): LocalStorage<Record<string, {
     status: true;
     checkedAt: string;

packages/cli-kit/dist/public/node/metadata.d.ts

@@ -34,7 +34,7 @@ export type SensitiveSchema<T> = T extends RuntimeMetadataManager<infer _TPublic
  * @returns A container for the metadata.
  */
 export declare function createRuntimeMetadataContainer<TPublic extends AnyJson, TSensitive extends AnyJson = Record<string, never>>(defaultPublicMetadata?: Partial<TPublic>): RuntimeMetadataManager<TPublic, TSensitive>;
-type CmdFieldsFromMonorail = PickByPrefix<MonorailEventPublic, 'cmd_all_'> & PickByPrefix<MonorailEventPublic, 'cmd_app_'> & PickByPrefix<MonorailEventPublic, 'cmd_create_app_'> & PickByPrefix<MonorailEventPublic, 'cmd_theme_'> & PickByPrefix<MonorailEventPublic, 'store_'> & PickByPrefix<MonorailEventPublic, 'env_auto_upgrade_'>;
+type CmdFieldsFromMonorail = PickByPrefix<MonorailEventPublic, 'cmd_all_'> & PickByPrefix<MonorailEventPublic, 'cmd_app_'> & PickByPrefix<MonorailEventPublic, 'cmd_create_app_'> & PickByPrefix<MonorailEventPublic, 'cmd_theme_'> & PickByPrefix<MonorailEventPublic, 'cmd_validate_'> & PickByPrefix<MonorailEventPublic, 'store_'> & PickByPrefix<MonorailEventPublic, 'env_auto_upgrade_'>;
 declare const coreData: RuntimeMetadataManager<CmdFieldsFromMonorail, {
     commandStartOptions: {
         startTime: number;

packages/cli-kit/dist/public/node/monorail.d.ts

@@ -77,6 +77,11 @@ export interface Schemas {
             cmd_app_validate_valid?: Optional<boolean>;
             cmd_app_validate_issue_count?: Optional<number>;
             cmd_app_validate_file_count?: Optional<number>;
+            cmd_validate_subcommand?: Optional<string>;
+            cmd_validate_result?: Optional<string>;
+            cmd_validate_api?: Optional<string>;
+            cmd_validate_api_version?: Optional<string>;
+            cmd_validate_json?: Optional<boolean>;
             cmd_dev_tunnel_type?: Optional<string>;
             cmd_dev_tunnel_custom_hash?: Optional<string>;
             cmd_dev_urls_updated?: Optional<boolean>;

[github-actions]

🫰✨ Thanks @alfonso-noriega! Your snapshot has been published to npm.

Test the snapshot by installing your package globally:

pnpm i -g --@shopify:registry=https://registry.npmjs.org @shopify/cli@0.0.0-snapshot-20260723204429

Caution

After installing, validate the version by running shopify version in your terminal.
If the versions don't match, you might have multiple global instances installed.
Use which shopify to find out which one you are running and uninstall it.