@veyralabs/skills 0.4.0 → 0.4.1

package/README.md

@@ -1,10 +1,13 @@
 # VeyraSkills
 
-Skills for Claude Code and other AI coding agents. Each skill is a plain text file that teaches your agent a specialized workflow — naming, branding, website cloning, and more.
+![7 skills](https://img.shields.io/badge/skills-7-blue) ![npm](https://img.shields.io/npm/v/@veyralabs/skills) ![license](https://img.shields.io/badge/license-MIT-green)
+
+Skills for Claude Code and other AI coding agents. Each skill is a plain text file that teaches your agent a specialized workflow - naming, branding, website cloning, Shopify development, and more.
 
 ```bash
 npx @veyralabs/skills install naming-suite
 npx @veyralabs/skills install webcloner
+npx @veyralabs/skills install shopify-suite
 ```
 
 Or install everything at once:
@@ -30,6 +33,15 @@ Four skills for naming products, auditing brands, mapping competitors, and build
 
 Works best in sequence: run `competitornames` to understand the landscape, then `domainforge` to generate names that stand out from it.
 
+### shopify-suite
+
+Two skills covering the full Shopify stack - one for developers building themes and apps, one for merchants auditing and optimizing stores.
+
+| Skill | What it does |
+|-------|-------------|
+| [shopify-dev](./skills/shopify-suite/shopify-dev/SKILL.md) | Shopify development across all layers: Liquid themes, JSON templates, app development with Remix, Storefront and Admin API, CLI workflows, checkout extensions, Hydrogen. Fetches live Shopify documentation via Context7 before answering version-sensitive questions |
+| [shopify-store](./skills/shopify-suite/shopify-store/SKILL.md) | Store audit and optimization. Works in two modes: Mode A uses shopify-mcp to read real store data (products, orders, apps, metafields); Mode B uses public extraction when MCP is not available. Audits 6 dimensions: catalog health, collection architecture, navigation, SEO, app stack, conversion signals |
+
 ### webcloner
 
 Clone any landing page, marketing site, portfolio, or ecommerce storefront into a pixel-accurate Next.js replica.
@@ -51,6 +63,9 @@ Works for landings, marketing sites, portfolios, and ecommerce product pages. No
 ```bash
 npx @veyralabs/skills install naming-suite
 npx @veyralabs/skills install webcloner
+npx @veyralabs/skills install shopify-suite
+npx @veyralabs/skills install shopify-dev
+npx @veyralabs/skills install shopify-store
 npx @veyralabs/skills install domainforge
 ```
 
@@ -109,14 +124,14 @@ npx @veyralabs/skills install domainforge
 ## Coming soon
 
 **brand-suite**
-- `brandvoice` — tone of voice guide generator
-- `brandpositioning` — positioning statement and competitive differentiation
-- `taglineforge` — tagline generation with scoring
+- `brandvoice` - tone of voice guide generator
+- `brandpositioning` - positioning statement and competitive differentiation
+- `taglineforge` - tagline generation with scoring
 
 **gtm-suite**
-- `icp` — Ideal Customer Profile builder
-- `pricingstrategy` — pricing model analysis
-- `gtmplan` — go-to-market plan generator
+- `icp` - Ideal Customer Profile builder
+- `pricingstrategy` - pricing model analysis
+- `gtmplan` - go-to-market plan generator
 
 ---
 
@@ -126,6 +141,9 @@ Each skill is also published as a standalone npm package if you only want one:
 
 - `@veyralabs/naming-suite`
 - `@veyralabs/webcloner`
+- `@veyralabs/shopify-suite`
+- `@veyralabs/shopify-dev`
+- `@veyralabs/shopify-store`
 
 ---
 

package/bin/cli.js

@@ -4,10 +4,17 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { execFileSync } = require('child_process');
 
 const SKILLS_DIR   = path.join(__dirname, '..', 'skills');
 const COMMANDS_DIR = path.join(__dirname, '..', 'commands');
 
+// pip packages required per skill
+const SKILL_PIP_DEPS = {
+  'shopify-store': ['scrapling'],
+  'webcloner':     ['scrapling'],
+};
+
 const AGENT_PATHS = {
   claude:    { local: '.claude/skills',             global: '.claude/skills' },
   cursor:    { local: '.cursor/skills',             global: '.cursor/skills' },
@@ -78,6 +85,31 @@ function copySkill(name, skillPath, dest) {
   console.log(`  ✓ ${name}`);
 }
 
+function installPipDeps(skillNames) {
+  const pkgs = [...new Set(skillNames.flatMap(n => SKILL_PIP_DEPS[n] || []))];
+  if (pkgs.length === 0) return;
+
+  let pip = null;
+  for (const cmd of ['pip3', 'pip']) {
+    try { execFileSync(cmd, ['--version'], { stdio: 'ignore' }); pip = cmd; break; } catch {}
+  }
+
+  if (!pip) {
+    console.log(`  ⚠ Python pip not found. Install manually: pip install ${pkgs.join(' ')}`);
+    return;
+  }
+
+  for (const pkg of pkgs) {
+    try {
+      console.log(`  Installing Python dependency: ${pkg}...`);
+      execFileSync(pip, ['install', pkg, '-q'], { stdio: 'inherit' });
+      console.log(`  ✓ ${pkg}`);
+    } catch {
+      console.log(`  ⚠ Failed to install ${pkg}. Run: ${pip} install ${pkg}`);
+    }
+  }
+}
+
 // Copy slash commands — Claude Code only (.claude/commands/)
 function copyCommands(agent, isGlobal) {
   if (agent !== 'claude') return;
@@ -170,6 +202,7 @@ if (command === 'install') {
   console.log(`\nInstalling into ${dest} [${agent}/${scope}]\n`);
   toInstall.forEach(name => copySkill(name, skills[name], dest));
   copyCommands(agent, isGlobal);
+  installPipDeps(toInstall);
   console.log('\nDone. Restart your agent to activate skills.\n');
   process.exit(0);
 }

package/install.sh

@@ -114,6 +114,37 @@ check_deps() {
   fi
 }
 
+# Skills that require Python packages: skill_name -> pip packages (space-separated)
+declare -A SKILL_PIP_DEPS=(
+  ["shopify-store"]="scrapling"
+  ["webcloner"]="scrapling"
+)
+
+install_pip_deps() {
+  local skill="$1"
+  local pkgs="${SKILL_PIP_DEPS[$skill]:-}"
+  [[ -z "$pkgs" ]] && return
+
+  local pip=""
+  for cmd in pip3 pip; do
+    command -v "$cmd" &>/dev/null && pip="$cmd" && break
+  done
+
+  if [[ -z "$pip" ]]; then
+    echo "  Warning: pip not found. Install manually: pip install $pkgs"
+    return
+  fi
+
+  for pkg in $pkgs; do
+    echo "  Installing Python dependency: $pkg..."
+    if "$pip" install "$pkg" -q; then
+      echo "  ✓ $pkg"
+    else
+      echo "  Warning: failed to install $pkg. Run: $pip install $pkg"
+    fi
+  done
+}
+
 install_skill() {
   local skill="$1"
   local dest_dir="$2"
@@ -236,11 +267,15 @@ main() {
   if [[ -n "$SKILL_NAME" ]]; then
     echo "Installing '$SKILL_NAME' → $dest/"
     install_skill "$SKILL_NAME" "$dest"
+    install_pip_deps "$SKILL_NAME"
     echo ""
     echo "Done. ${dest}/${SKILL_NAME}/ is ready."
   else
     echo "Installing all skills → $dest/"
     install_all "$dest"
+    for skill in "${!SKILL_PIP_DEPS[@]}"; do
+      install_pip_deps "$skill"
+    done
     echo ""
     echo "Done. All skills installed to ${dest}/"
   fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veyralabs/skills",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "VeyraSkills — A curated collection of Claude Code skills for founders, developers and AI builders",
   "bin": {
     "veyraskills": "bin/cli.js"