javeedishaq/shopify-translations
skills/shopify/translations/SKILL.md
Manage Shopify store translations with French as source language. Use when working with translation files, updating translations, or managing multi-language Shopify content. Triggers on "translate", "translations", "localization", "i18n", "French to German/Italian/English".
$ install --global
skillsauthnpx skillsauth add javeedishaq/ai-workflow-orchestrator shopify-translationsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 3:10 AM7.1s1 file scanned
SKILL.md
- name:
- shopify-translations
- description:
- Manage Shopify store translations with French as source language. Use when working with translation files, updating translations, or managing multi-language Shopify content. Triggers on "translate", "translations", "localization", "i18n", "French to German/Italian/English".
Shopify Translations Management
Two separate translation systems - use the right one for each case.
Two Translation Systems
| System | Use For | Location |
|--------|---------|----------|
| API Translations | Merchant-editable content, block settings | translations-to-edit.json |
| Locale Files | Hardcoded theme text, labels, buttons | shopify-theme/locales/*.json |
1. API Translations (Merchant Content)
French (fr_original) as source → German, Italian, English.
Structure
{
"key": "section.page.json.heading:id",
"fr_original": "Design Gratuit",
"de_fixed": "Kostenlose Gestaltung",
"de_status": "completed",
"it_fixed": "Design Gratuito",
"it_status": "completed",
"en_fixed": "Free Design",
"en_status": "completed"
}
Status Values
pending- Not yet translatedcompleted- Ready to publishverified- Reviewed and approved
Commands
npm run translations:myarmy:extract # Extract from Shopify
npm run translations:myarmy:review # Generate review report
npm run translations:myarmy:translate # Auto-translate (needs OPENAI_API_KEY)
npm run translations:myarmy:publish # Publish to Shopify
npm run translations:myarmy:backup # Create backup
npm run translations:myarmy:workflow # Full workflow
2. Locale Files (Theme Code)
For hardcoded theme text only - stored in Git.
File Locations
shopify-theme/locales/
├── en.default.json # English source
├── fr.json # French
├── de.json # German
└── it.json # Italian
Key Structure (3-level nested)
{
"products": {
"benefits": {
"lifetime_guarantee": "Lifetime Guarantee",
"lifetime_description": "Yes, you read that right..."
}
}
}
Usage in Liquid
{{ 'products.benefits.lifetime_guarantee' | t }}
{{ 'products.benefits.lifetime_description' | t: default: 'Fallback' }}
Deployment
# Push locale files to production
shopify theme push --theme=185946079581 --store=087ffd-4a.myshopify.com \
--allow-live --only="locales/"
When to Use Which
| Content Type | Use | |--------------|-----| | Section titles, labels | Locale files | | Error messages | Locale files | | Button text | Locale files | | Block settings content | API translations | | Product descriptions | API translations | | Merchant-editable text | API translations |
Swiss Military Terminology
Always use:
- ✅ badge (NOT "écusson")
- ✅ section (NOT "peloton")
Key Rules
DO:
- Keep French as source (fr_original)
- Keep all 4 locale files in sync
- Review before publishing
- Create backups before major changes
DON'T:
- Edit fr_original directly
- Mix the two translation systems
- Skip review step
- Forget to update all language files
Environment Variables
SHOPIFY_ACCESS_TOKEN=shpat_...
SHOPIFY_STORE_DOMAIN=087ffd-4a.myshopify.com
OPENAI_API_KEY=sk-... # Optional, for auto-translation
Related Skills
javeedishaq/templates/skills/test-patterns
tools
VerifiedTrustedCommunity
# Test Patterns Testing patterns for reliable, maintainable, and fast tests. > **Template Usage:** Customize for your test framework (Vitest, Jest, Playwright, etc.) and assertion library. ## Test Structure ```typescript // user.test.ts import { describe, it, expect, beforeEach, afterEach } from 'vitest'; import { userService } from '@/services/user.service'; import { createTestUser, cleanupTestData } from '@/tests/helpers'; describe('UserService', () => { let testUserId: string; befor
1SKILL.mdUpdated Apr 6, 2026
javeedishaq/templates/skills/state-management
tools
VerifiedTrustedCommunity
# State Management Patterns Client-side state management patterns for modern applications. > **Template Usage:** Customize for your state library (React Query, Zustand, Jotai, Redux, etc.). ## State Categories | Type | Description | Solution | |------|-------------|----------| | **Server State** | Data from API/database | React Query, SWR | | **Client State** | UI state, user preferences | Zustand, Jotai, useState | | **Form State** | Form inputs, validation | React Hook Form, Formik | | **U
1SKILL.mdUpdated Apr 6, 2026
javeedishaq/templates/skills/service-patterns
development
VerifiedTrustedCommunity
# Service Patterns Service layer patterns for clean architecture with proper error handling, logging, and type safety. > **Template Usage:** Customize for your ORM (Prisma, Drizzle, TypeORM, etc.) and logging solution. ## Result Type Pattern Never throw exceptions from services. Always return a Result type. ```typescript // lib/result.ts export type Result<T, E = Error> = | { success: true; data: T } | { success: false; error: E }; export function ok<T>(data: T): Result<T, never> { r
1SKILL.mdUpdated Apr 6, 2026
javeedishaq/templates/skills/rls-security
testing
VerifiedTrustedCommunity
# Row-Level Security Patterns Database security patterns for multi-tenant and user-scoped data. > **Template Usage:** Customize for your database (PostgreSQL, Supabase, etc.) and auth system. ## RLS Fundamentals ### Enable RLS on Tables ```sql -- Enable RLS (required before policies take effect) ALTER TABLE users ENABLE ROW LEVEL SECURITY; ALTER TABLE posts ENABLE ROW LEVEL SECURITY; ALTER TABLE comments ENABLE ROW LEVEL SECURITY; -- Force RLS for table owners too (recommended) ALTER TABLE
1SKILL.mdUpdated Apr 6, 2026