td-ai-tools 1.1.9 → 1.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "td-ai-tools",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Install agent skills and packs into your project",
   "type": "module",
   "scripts": {

package/skills/README.md

@@ -16,6 +16,7 @@
 - `pull-request-statamic`: Generates GitHub pull request descriptions for Statamic and Laravel development by analyzing git diffs and…
 - `record-changes`: Update `docs/changes.md` by summarizing the current branch against the primary development branch.
 - `scry`: Single-site visual regression workflow for comparing a live URL against a preview/staging URL in Playwright…
+- `shopify-cli`: Shopify CLI workflows for theme development. Use when the user needs to run or explain Shopify theme commands,…
 - `stylesheet-migration`: Migrate Shopify Liquid `{% stylesheet %}` blocks into theme CSS assets using bundled Python scripts.
 - `td-js-vanilla-rules`: Theory Digital vanilla JavaScript standards for Shopify theme work.
 - `td-review`: Run parallel code review agents on a PR (including TD theme compliance) and produce a synthesized findings…

package/skills/shopify-cli/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: shopify-cli
+version: 1.0.0
+description: Shopify CLI workflows for theme development. Use when the user needs to run or explain Shopify theme commands, especially starting the theme development server, previewing local Liquid/theme changes, listing themes, pushing or pulling theme files, duplicating themes, renaming themes, or checking other Shopify CLI theme command syntax.
+---
+
+# Shopify CLI
+
+Official docs: https://shopify.dev/docs/api/shopify-cli/theme
+
+## First Step: Store Config
+
+Read `config.toml` in this skill folder before running any Shopify theme command that talks to a store.
+
+- Use the configured `store` value as the `--store` argument every time.
+- If `store` is empty or missing, stop and ask the user for the correct Shopify store value before running commands.
+- Accept either the store prefix or the full `.myshopify.com` host. Do not rely on Shopify CLI's cached last-used store, because it can point at a different repo's store.
+
+## Development Server
+
+Primary workflow:
+
+```bash
+shopify theme dev --store <configured-store>
+```
+
+Use from the Shopify theme root, where the standard theme directories such as `layout/`, `templates/`, `sections/`, `snippets/`, `assets/`, `config/`, and `locales/` are available.
+
+Common options:
+
+```bash
+shopify theme dev --store <configured-store> --port 9292
+shopify theme dev --store <configured-store> --host 0.0.0.0 --port 9292
+shopify theme dev --store <configured-store> --theme-editor-sync
+shopify theme dev --store <configured-store> --only "sections/*.liquid"
+shopify theme dev --store <configured-store> --ignore "config/settings_data.json"
+```
+
+Safety rules:
+
+- Do not use `--allow-live` for development server work unless the user explicitly requests live-theme development after acknowledging the risk.
+- Prefer a development theme or unpublished theme for previewing.
+- If the command prompts for authentication, let the user complete the browser login or provide the approved Theme Access token flow.
+
+## Progressive Disclosure
+
+Read only the reference file needed for the user's task:
+
+- `references/theme-management.md`: list, push, pull, duplicate, and rename. Use this for the second-most common workflow group.
+- `references/other-theme-commands.md`: check, console, delete, info, init, language-server, metafields pull, open, package, preview, profile, publish, and share.
+
+## Global Safety
+
+- Never push to the live theme. Do not provide live-push command syntax.
+- Never publish a theme or rename/delete a live theme unless the user explicitly asks for that exact production action.
+- Prefer `--json` for commands whose output will be parsed by automation.
+- Prefer explicit `--theme <id-or-name>` when the user has identified the target theme; otherwise expect Shopify CLI to prompt.
+- Before destructive or overwriting commands, identify the store and target theme in the user-facing update.

package/skills/shopify-cli/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Shopify CLI"
+  short_description: "Run Shopify theme CLI workflows"
+  default_prompt: "Use $shopify-cli to start the Shopify theme development server."

package/skills/shopify-cli/config.toml

@@ -0,0 +1,4 @@
+# Required before running Shopify CLI store-scoped theme commands.
+# Set to the store prefix or full myshopify.com host, for example:
+# store = "example.myshopify.com"
+store = ""

package/skills/shopify-cli/references/other-theme-commands.md

@@ -0,0 +1,72 @@
+# Other Shopify Theme Commands
+
+Use this reference for Shopify CLI theme commands outside the primary dev-server and management workflows.
+
+Official command index: https://shopify.dev/docs/api/shopify-cli/theme
+
+Read `../config.toml` first for commands that talk to a store, and always pass `--store <configured-store>` when the command supports it.
+
+## Local Analysis And Tooling
+
+```bash
+shopify theme check
+shopify theme check --path <theme-path>
+shopify theme console
+shopify theme language-server
+shopify theme package
+```
+
+- `theme check`: run Theme Check for Liquid/theme best practices and errors.
+- `theme console`: start the Liquid REPL.
+- `theme language-server`: start the theme language server.
+- `theme package`: create a ZIP package from local theme files.
+
+## Store And Theme Information
+
+```bash
+shopify theme info --store <configured-store>
+shopify theme open --store <configured-store>
+shopify theme open --store <configured-store> --theme <theme-id-or-name>
+shopify theme share --store <configured-store>
+shopify theme profile --store <configured-store> --url <path-or-url>
+```
+
+- `theme info`: show theme environment information, including current store.
+- `theme open`: return preview/admin links for a theme.
+- `theme share`: upload as a new unpublished theme and return a shareable preview.
+- `theme profile`: profile Liquid rendering on a page.
+
+## Creating Or Bootstrapping
+
+```bash
+shopify theme init <directory>
+shopify theme init <directory> --clone-url <git-url>
+```
+
+Use `theme init` to clone a starting theme into a local directory.
+
+## Metafields
+
+```bash
+shopify theme metafields pull --store <configured-store>
+```
+
+Use this to retrieve Shopify Admin metafields for theme development.
+
+## Preview Overrides
+
+```bash
+shopify theme preview --store <configured-store> --theme <theme-id-or-name> --overrides <overrides-file>
+```
+
+Use this to apply JSON overrides to a theme preview.
+
+## Destructive Or Production Commands
+
+```bash
+shopify theme delete --store <configured-store> --theme <theme-id-or-name>
+shopify theme publish --store <configured-store> --theme <theme-id-or-name>
+```
+
+- `theme delete`: destructive. Require explicit user confirmation for the exact store and theme.
+- `theme publish`: production-impacting. Do not run unless the user explicitly asks to publish the exact theme.

package/skills/shopify-cli/references/theme-management.md

@@ -0,0 +1,95 @@
+# Shopify Theme Management
+
+Use this reference for listing, pushing, pulling, duplicating, and renaming themes.
+
+Official docs:
+
+- https://shopify.dev/docs/api/shopify-cli/theme/theme-list
+- https://shopify.dev/docs/api/shopify-cli/theme/theme-push
+- https://shopify.dev/docs/api/shopify-cli/theme/theme-pull
+- https://shopify.dev/docs/api/shopify-cli/theme/theme-duplicate
+- https://shopify.dev/docs/api/shopify-cli/theme/theme-rename
+
+Always read `../config.toml` first and pass `--store <configured-store>`. If the store is not configured, ask the user before running anything. Never use Shopify CLI's cached last store.
+
+## List Themes
+
+Purpose: list themes in the configured store with IDs and roles.
+
+```bash
+shopify theme list --store <configured-store>
+shopify theme list --store <configured-store> --json
+shopify theme list --store <configured-store> --role unpublished
+shopify theme list --store <configured-store> --name "<partial-name>"
+shopify theme list --store <configured-store> --id <theme-id>
+```
+
+Use `--json` when another command needs a theme ID.
+
+## Push Theme Files
+
+Purpose: upload local theme files. This can overwrite remote theme files, so name the target store and theme before running.
+
+Allowed patterns:
+
+```bash
+shopify theme push --store <configured-store> --unpublished --json
+shopify theme push --store <configured-store> --theme <theme-id-or-name> --strict
+shopify theme push --store <configured-store> --theme <theme-id-or-name> --nodelete
+shopify theme push --store <configured-store> --theme <theme-id-or-name> --only "sections/*.liquid"
+shopify theme push --store <configured-store> --theme <theme-id-or-name> --ignore "config/settings_data.json"
+shopify theme push --store <configured-store> --development
+shopify theme push --store <configured-store> --development-context <context-name>
+```
+
+Forbidden:
+
+- Do not push to the live theme.
+- Do not use `--live`, `--publish`, or `--allow-live`.
+- Do not provide command syntax for live pushes.
+
+Notes:
+
+- If no theme is specified, Shopify CLI prompts the user to choose a target theme.
+- `--unpublished` creates a new unpublished theme.
+- `--strict` requires Theme Check to pass without errors before pushing.
+- `--nodelete` avoids deleting remote files that are absent locally.
+
+## Pull Theme Files
+
+Purpose: retrieve theme files from Shopify. Pulling can overwrite local files.
+
+```bash
+shopify theme pull --store <configured-store>
+shopify theme pull --store <configured-store> --theme <theme-id-or-name>
+shopify theme pull --store <configured-store> --development
+shopify theme pull --store <configured-store> --nodelete
+shopify theme pull --store <configured-store> --only "templates/*.json"
+shopify theme pull --store <configured-store> --ignore "config/settings_data.json"
+```
+
+Avoid pulling the live theme unless the user explicitly asks for it and understands that local files may be overwritten.
+
+## Duplicate Themes
+
+Purpose: duplicate an existing remote theme. Shopify CLI prompts if no target theme is supplied.
+
+```bash
+shopify theme duplicate --store <configured-store>
+shopify theme duplicate --store <configured-store> --theme <theme-id-or-name> --name "<new-theme-name>"
+shopify theme duplicate --store <configured-store> --theme <theme-id-or-name> --name "<new-theme-name>" --json
+```
+
+Use `--force` only when the user has already confirmed the exact source theme, because it suppresses prompts and confirmations.
+
+## Rename Themes
+
+Purpose: rename a remote theme.
+
+```bash
+shopify theme rename --store <configured-store>
+shopify theme rename --store <configured-store> --theme <theme-id-or-name> --name "<new-theme-name>"
+shopify theme rename --store <configured-store> --development --name "<new-theme-name>"
+```
+
+Do not rename the live theme unless the user explicitly asks for that production change.